Skip to content
CAI
Software that uses CAICheck a score

zio/interop-cats

54.5

Adequate · 7 November 2026

4.9k

lines of production code

Scala

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add Cats Show-based console printing utilities

The zio-interop-cats module now includes a new \cats.scala\ file that provides \print\ and \printLine\ functions. These functions allow users to print values to the console by leveraging Cats' \Show\ type class, automatically converting the value to a string representation before delegating to ZIO's standard console output.

zio-interop-cats/shared/src/main/scala/zio/interop/console · high confidence

Add Scala Native support

The library now supports Scala Native, enabling users to run zio-interop-cats on the Native platform. This includes platform-specific implementations for blocking operations in the \jvm-native\ source directory and specific interop instances for FS2 Unix sockets in the \native\ directory, alongside a no-op tracer implementation for the \js-native\ target.

(repo-wide) · high confidence

Add ScalaCheck instances for ZIO law testing

The \zio-interop-cats-laws\ module now provides \Arbitrary\, \Cogen\, and \Eq\ instances for ZIO effects, streams, and managed resources, enabling users to run cats-effect law tests against ZIO code. This change introduces test infrastructure including a deterministic \TestContext\-backed clock and runtime, allowing effects to be executed and compared deterministically during property-based testing.

zio-interop-cats-laws/shared · high confidence

Added ZIO Test interop for Cats Effect

This change introduces the \zio-test-interop-cats\ module, providing a bridge between ZIO Test and Cats Effect. It adds \CatsTestFunctions\ (accessible via \catz.test\) which allow users to write ZIO tests that directly evaluate Cats Effect \IO\ actions using \assertF\, \checkF\, \checkAllF\, \checkSomeF\, and \testF\. The module also includes \CatsRunnableSpec\ to manage the necessary \Dispatcher\ lifecycle for running these tests, along with \TestSpec\ demonstrating the usage.

zio-test-interop-cats/shared · high confidence

New InteropTracer artifact for JVM stack trace interop

A new \zio-interop-tracer\ artifact has been introduced for the JVM platform, containing the \InteropTracer\ object. This component provides a caching mechanism to generate stack traces from arbitrary objects by leveraging Akka's line number utilities, handling various source info formats and lambda naming patterns to produce standardized trace strings.

zio-interop-tracer/jvm · high confidence

New ZIO-to-Cats Effect interop layer for queues, hubs, and schedules

This release adds a comprehensive set of new Scala source files in the zio-interop-cats shared module that bridge ZIO concurrency primitives to Cats Effect typeclasses. Specifically, it introduces \Queue\, \Hub\, \Enqueue\, and \Dequeue\ wrappers that expose ZIO's queue and hub capabilities as Cats Effect \Async\ effects, along with a \Schedule\ interop layer for Cats Effect scheduling. Additionally, it provides \CatsNonEmptyListSyntax\ to enable \foreach\, \collectAll\, and their parallel variants on \cats.data.NonEmptyList\ within ZIO effects, and extends \CatsMtlInstances\ with \Ask\ and \Local\ instances backed by \FiberRef\ for any ZIO environment.

zio-interop-cats/shared/src/main/scala/zio/interop · high confidence

New ZStream and fs2 interop syntax and type class instances

This change introduces new files in the zio-interop-cats stream interop module that provide syntax extensions and type class instances for converting between ZIO streams and fs2 streams. Specifically, it adds \FS2StreamSyntax\ which enables implicit conversions via \toFs2Stream\ (ZStream to fs2) and \toZStream\ (fs2 to ZStream, with configurable queue sizing and chunking for performance). It also defines \CatsInstances\ providing \MonadError\, \Alternative\, \MonoidK\, \Bifunctor\, and \Parallel\ instances for \ZStream\, and adds \fs2z\ objects to expose \Files\ and \Network\ instances for ZIO's \RIO\ effect type, enabling seamless integration of fs2 I/O components with ZIO.

zio-interop-cats/shared/src/main/scala/zio/stream · high confidence

STM interop layer for Cats Effect

The \zio.interop.stm\ package now provides a compatibility layer that allows ZIO's Software Transactional Memory (STM) primitives—specifically \STM\, \TRef\, \TQueue\, \TPromise\, and \TSemaphore\—to be used within Cats Effect \F\[\_\]\ effect types. This enables users to execute STM transactions via \STM.atomically\ and interact with transactional references, queues, promises, and semaphores using Cats Effect's \Async\ context, bridging the two effect systems.

zio-interop-cats/shared/src/main/scala/zio/interop/stm · high confidence

Behavioural changes

Library updated to ZIO 2.1.1 and Cats Effect 3 with new autocatch support

The library has been upgraded to support ZIO 2.1.1 and Cats Effect 3, replacing the previous Cats Effect 2 instances. This update introduces new typeclass instances (\Concurrent\, \Temporal\, \Async\) for ZIO's \Task\ and \RIO\ types, enabling integration with modern Typelevel libraries like fs2 and doobie. A key behavioral addition is the \autocatch\ module, which provides alternative instances that allow Cats Effect error-handling methods (like \handleErrorWith\) to recover from ZIO defects, addressing a common compatibility gap. The documentation has also been updated to reflect these changes and the new installation instructions.

(repo-wide) · high confidence

Stack tracer logic moved to new zio-interop-tracer artifact

The internal stack-tracing implementation, including the JVM-specific bytecode parser for line numbers (AkkaLineNumbers), has been extracted from the main repository into a separate artifact named zio-interop-tracer. This change isolates the tracing functionality, making it available as a distinct dependency for users who need stack trace interoperability without pulling in the full core library.

repository · high confidence

Fixes

Fix ZIO blocking operations on Scala.js

The Scala.js-specific implementation for ZIO blocking operations has been corrected to ensure that \delay\, \blocking\, and \interruptible\ actions are properly executed using \ZIO.attempt\. This change resolves issues where these operations might not have behaved correctly on the JavaScript platform, ensuring consistent error handling and execution semantics for users running this library in a browser or Node.js environment.

zio-interop-cats/js · high confidence

Test coverage

Added Scala Native test suite for zio-interop-cats; Added ZStream type-class law tests; Added comprehensive test coverage for ZIO-Cats interop; Added comprehensive tests for Cats-ZIO interop cancellation and error propagation; Added tests for catz.core implicits and NonEmptyList syntax; Added tests for the InteropTracer stack-trace utility.

Dependencies

Build infrastructure updated to SBT 2.0 and Scala 3.3.8

The project build has been upgraded to SBT 2.0.10 and now targets Scala 3.3.8 (alongside 2.13.18 and 2.12.21). This update includes a comprehensive refresh of build plugins, such as sbt-scalajs 1.22.0, sbt-scala-native 0.5.12, and sbt-bloop 2.1.2, and enables parallel test execution by default. Additionally, the build now generates build info for the main interop library and the separate zio-interop-tracer artifact, and configures the compiler to use Java 11 bytecode for Scala 3 lazy vals to ensure compatibility with JDK 24+.

project · high confidence

Update ZIO, Cats, and FS2 dependencies to latest versions

The build configuration has been updated to use ZIO 2.1.26, Cats 2.13.0, Cats Effect 3.7.1, FS2 3.14.0, and scala-java-time 2.7.0. This brings the library in line with the latest stable releases of its core dependencies, ensuring compatibility and access to recent improvements in the ZIO and Cats ecosystems.

(dependencies) · 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 61 → 54 (-6.9)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 63 → 63 (+0.0)
  • Architecture 97 → 97 (+0.0)
  • Maturity 52 → 51 (-0.9)
  • Readiness 79 → 62 (-16.9)
  • Security 68 → 47 (-21.3)
  • Performance 82 → 100 (+18.3)

Resolved (4)

  • Dependency hygiene PARTLY measured — sbt declarations read, no exact version to grade for currency
  • Documentation: no installation or build instructions (README.md)
  • Documentation: no usage examples (README.md)
  • Off-boarding risk: anonymized user #1

New (2)

  • Dependency hygiene PARTLY measured — sbt declarations read, dependency currency not (Maven Central unreachable)
  • Off-boarding risk: anonymized user #1

Changes since last survey

  • 1 commits — 1 feature/other, 0 fixes

By area

  • project/BuildHelper.scala — 1 commit

Notable commits

  • change: Update scala3-library_sjs1_3 to 3.3.9 (#794)

Architecture

  • Unchanged — 0 containers · 1 contexts · 0 edges

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

zio/interop-cats 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 8c6efc124fe80c1770116d72bd1c46c99771b198 — 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-5f8314471808.