parapet-io/parapet
62.1
Adequate · 7 November 2026
7.9k
lines of production code
Scala
primary language
4
measurements over time
What this system is
Parapet is a Scala 3 distributed systems toolkit that implements an actor model for building isolated, event-driven processes. It provides a modular architecture with a core runtime for process lifecycle and request/response channels, alongside pluggable backends like Cats Effect and a reference ParIO interpreter. The system supports distributed communication through a networking layer with ZeroMQ and Aeron implementations, ensuring reliable message delivery and serialization across nodes.
Features
Added WireCodec type class for protocol serialization
The parapet-protocol module now includes a new WireCodec type class that defines how application-level values are serialized to and deserialized from raw bytes for transport. This abstraction allows transport code to remain polymorphic over payload types, with built-in support for raw byte arrays (using defensive cloning) and UTF-8 encoded strings.
parapet-protocol · high confidence
Introduce Cats Effect IO backend for Parapet
The new \parapet-cats-effect\ module provides a production-ready backend that runs Parapet processes on Cats Effect \IO\. It includes \CatsEffectParapetRuntime\ to manage scheduler and blocking thread pools, implements the \Effect\[IO\]\ and \Parallel\[IO\]\ typeclasses (including uncancellable execution and fiber outcome mapping), and offers the \CatsEffectParApp\ trait as a convenience base for applications. The module also ships with comprehensive integration tests and benchmarks to validate behavior and performance.
parapet-cats-effect · high confidence
Introduce ParIO effect type and reference runtime for Parapet processes
The \parapet-pario\ module now provides a reference \ParIO\ effect type and its corresponding \ParIORuntime\, enabling users to define and run Parapet processes using this built-in interpreter. This includes a \ParIOApp\ trait for application entry points, a configurable runtime with dedicated thread pools for scheduling, parallelism, async, blocking, and timers, and support for fiber cancellation, masking, and finalizers. Comprehensive integration tests verify process recovery, journal recording, snapshotting, and delivery semantics when using the ParIO backend.
parapet-pario/src · high confidence
Introduces core actor runtime with request/response channels and dead-letter handling
The \parapet-core\ module now provides the foundational actor runtime, including the \Process\ trait for defining isolated, event-driven units of behavior and \ProcessRef\ for stable, opaque addressing. A new \Channel\ class enables synchronous-style request/response interactions between processes, enforcing a strict one-outstanding-call discipline and correlating replies via causation IDs. The runtime also introduces a \DeadLetterProcess\ to capture and log events that cannot be delivered, along with a suite of system events (such as \Initialize\, \Start\, \Stop\, and \Failure\) to manage process lifecycle and error propagation. Application bootstrapping is handled by \ParApp\, which wires together the scheduler, DSL interpreter, and optional snapshot/journal storage, while \ParConfig\ allows tuning of scheduler workers, mailbox buffers, and fault injection policies.
parapet-core/src · high confidence
New network transport layer with process-based abstractions and ZMQ/Aeron implementations
The \parapet-net\ module introduces a complete networking stack built on top of the actor/process model. It defines transport protocols (TCP, UDP) and three transport abstractions: \ClientTransport\ for request/reply, \ServerTransport\ for routed request/reply, and \DuplexTransport\ for bidirectional messaging. These are wrapped in \ClientProcess\, \ServerProcess\, \DatagramProcess\, and \DuplexProcess\ to handle lifecycle, correlation IDs, and routing. Wire format is standardized via a Protobuf schema (\wire.proto\) and a \MessageCodec\. Concrete implementations are provided for ZeroMQ (ZMQ) over TCP (using \ZmqSocketWorker\ for thread safety) and Aeron UDP. The change also includes integration and unit tests for these processes and transports.
parapet-net/src · high confidence
Removals
Removal of core Parapet module and package definitions
The \Parapet.scala\ file, which contained the core Actor model implementation including the Flow and Effect ADTs, their interpreters, and the Process trait, has been deleted. Additionally, the \package.scala\ file defining the \catsInstances\ object for implicit Flow and Effect access has been removed. This eliminates the previously available core concurrency primitives and their associated implicit instances from the \io.parapet.core\ package.
src/main · high confidence
Test coverage
New backend-agnostic integration test suite for Parapet; Removed FlowSpec test suite.
Dependencies
Upgrade to Scala 3 and modernize dependency versions
The project has migrated from Scala 2.12 to Scala 3.3.4, requiring users to update their build environment. This change includes significant version bumps for core dependencies: Cats Effect is upgraded from 1.2.0 to 3.5.7, ScalaTest from 3.0.7 to 3.2.19, and Logback from an unspecified older version to 1.5.6. Additionally, new dependencies for networking and protocol handling have been added, including ZeroMQ (jeromq 0.6.0), Aeron (1.50.3), Avro4s (5.0.13), and ScalaPB. The build structure has also been reorganized into multiple submodules (core, testkit, cats-effect, pario, protocol, net).
(dependencies) · high confidence
Housekeeping
Initial project setup and documentation
This change establishes the foundational structure of the Parapet project, introducing the Apache 2.0 license, a comprehensive README describing the Scala 3 distributed systems toolkit, and a release workflow guide. It also configures the development environment with a Scala 3 formatting configuration (.scalafmt.conf) and a Travis CI build script targeting Scala 3.8.3 with OpenJDK 21, alongside updated .gitignore rules to exclude build artifacts and IDE files.
(repo-wide) · high confidence
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 56 → 62 (+5.6)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 58 → 58 (+0.0)
- Architecture 92 → 91 (-1.2)
- Maturity 49 → 72 (+23.7)
- Readiness 52 → 54 (+2.0)
- Security 88 → 81 (-6.3)
- Performance 90 → 100 (+9.7)
Resolved (6)
- Outdated: com.lihaoyi:sourcecode_3
- Outdated: com.sksamuel.avro4s:avro4s-core_3
- Outdated: com.typesafe.scala-logging:scala-logging_3
- Outdated: io.aeron:aeron-all
- Outdated: org.scalatest:scalatest_3
- Outdated: org.typelevel:cats-effect_3
New (1)
- Dependency hygiene PARTLY measured — sbt declarations read, dependency currency not (Maven Central unreachable)
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
parapet-io/parapet was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 7 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit cf77c7b740ddd8aa59eb9af40dc9c14d3e8c0ae2 — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.3+preprod-c34be012586e.