zio/zio-query
54.6
Adequate · 7 November 2026
4.1k
lines of production code
Scala
primary language
4
measurements over time
What this system is
Features
ZIO Query library initialization with core query execution and caching components
This change introduces the initial implementation of the ZIO Query library, providing the foundational types and behaviors for building composable, batched, and cached queries. It defines the \ZQuery\ effect type and associated type aliases (\Query\, \UQuery\, etc.) in the package object, along with the \Request\ trait for modeling data dependencies. The library includes a \Cache\ abstraction backed by a \ConcurrentHashMap\ to deduplicate and cache request results, and a \DataSource\ trait that allows users to define how batches of requests are executed and optimized. Additionally, it introduces \DataSourceAspect\ and \QueryAspect\ for weaving cross-cutting concerns like batching limits (\maxBatchSize\) and around-hooks into the query execution pipeline, alongside internal structures like \Parallel\ and \Sequential\ to manage request scheduling.
zio-query/shared/src/main · high confidence
Removals
Removal of internal ZQuery execution engine components
The internal implementation details of the ZQuery library have been removed from the \zquery/shared\ module. This includes the deletion of core execution and state-management classes such as \ZQuery\, \DataSource\, \Result\, \Cache\, \BlockedRequest\, \BlockedRequestMap\, \CompletedRequestMap\, and \QueryFailure\, along with their associated type aliases in \package.scala\ and the \ZQuerySpec\ test suite. This change eliminates the library's internal machinery for batching, deduplication, and caching of data source requests.
zquery/shared · high confidence
Remove legacy Docusaurus v1 microsite
The website directory's Docusaurus v1 microsite has been removed. This change deletes the core React components (Footer, Home page), the site configuration, sidebar definitions, custom CSS, and associated static assets (SVG images) that previously powered the old documentation site.
website · high confidence
Behavioural changes
Project rebranded to ZIO Query with updated build configuration and documentation
The project has been rebranded from 'zquery' to 'ZIO Query', reflected in the updated README.md which now describes the library's batching, pipelining, and caching capabilities and updates installation instructions to the 'dev.zio' Maven group ID. The build environment has been modernized by replacing the legacy 'sbt-extras' runner with the standard SBT launcher, configuring JVM memory and garbage collection settings in a new .sbtopts file, and upgrading the Scala formatting tool (Scalafmt) from version 2.3.2 to 3.7.14. Additionally, the Node.js version required for the documentation site has been updated from v10.8.0 to v20.8.1, and a .scalafix.conf file has been added to enforce code style rules such as import organization and syntax disabling.
(repo-wide) · high confidence
ZQuery library upgraded to ZIO 2 and restructured
The ZQuery library has been upgraded to ZIO 2, introducing significant performance optimizations for query execution, including reduced overhead in data source-backed queries, parallel operations, and caching. The internal architecture has been refactored with new core components like \BlockedRequests\, \Continue\, \Result\, and \QueryScope\ to improve batching and pipelining efficiency. Additionally, the package structure has been migrated from \zquery\ to \zio.query\, and new benchmarking tools have been added to measure throughput against alternatives like \fetch\.
repository · high confidence
Test coverage
Added JMH benchmarks for ZQuery execution performance; Added test suite for ZQuery execution and batching behavior.
Dependencies
Migrate build infrastructure to ZIO SBT Ecosystem and update tooling
The project's build system has been significantly restructured by replacing a large set of individual sbt plugins with the unified \zio-sbt-ecosystem\ and \zio-sbt-website\ plugins (version 0.5.1). This change consolidates management of Scala.js (upgraded to 1.20.2), Scala Native (added via sbt-scala-native 0.5.10), and other cross-building concerns. Additionally, the custom \BuildHelper.scala\ utility object has been removed, and core build properties have been updated, including the sbt version bump from 1.3.7 to 1.12.11 and updates to sbt-scoverage (2.4.4), sbt-mima-plugin (1.1.4), and sbt-buildinfo (0.13.1).
project · high confidence
Upgrade to ZIO 2.1 and Scala 3.3 with Native platform support
The project has upgraded its core dependency from ZIO 1.x to ZIO 2.1.24 and updated Scala versions to support 2.12.21, 2.13.18, and 3.3.7. This change introduces support for the Scala Native platform alongside existing JVM and JS targets, renames the main library module from 'zquery' to 'zio-query', and migrates the build to use the ZIO SBT Ecosystem Plugin with MiMa for binary compatibility checking. Additionally, the documentation site structure was updated, replacing the old Docusaurus-based website with a new setup under the 'docs' directory.
(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
This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.
Score
- CAI 61 → 55 (-6.0)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 74 → 74 (+0.0)
- Architecture 98 → 98 (+0.0)
- Maturity 47 → 47 (-0.8)
- Readiness 75 → 62 (-12.9)
- Security 65 → 49 (-16.1)
- Performance 85 → 91 (+6.7)
Resolved (45)
- Fork-triggerable workflow runs with an unscoped write token (.github/workflows/auto-approve.yml)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- …and 25 more
New (52)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- High: security finding (details withheld)
- …and 32 more
Changes since last survey
- 20 commits — 20 feature/other, 0 fixes
By area
- project/plugins.sbt — 5 commits
- (root) — 4 commits
- docs/creating-data-sources.md — 2 commits
- project/build.properties — 2 commits
- (repo) — 1 commit
- .github/workflows — 1 commit
- benchmarks/src — 1 commit
- docs/aspects.md — 1 commit
- docs/completed-request-map.md — 1 commit
- docs/creating-queries.md — 1 commit
- zio-query/shared — 1 commit
Notable commits
- change: Bump scala-steward-org/scala-steward-action from 2.96.0 to 2.97.0 (#534)
- change: Update README.md (#530)
- change: Update sbt, scripted-plugin to 1.12.15 (#541)
- change: Update sbt, scripted-plugin to 1.13.1 (#544)
- change: Update sbt-buildinfo to 0.13.2 (#535)
- change: Update sbt-mima-plugin to 1.1.6 (#536)
- change: Update sbt-mima-plugin to 1.2.1 (#546)
- change: Update sbt-scala-native to 0.5.12 (#540)
- change: Update sbt-scalajs to 1.22.0 (#538)
- change: Update scala3-library, ... to 3.3.9 (#539)
- change: Update scalafmt-core to 3.11.5 (#545)
- change: Update scalafmt-core to 3.7.17 (#542)
- change: Update zio, zio-test, zio-test-sbt to 2.1.27 (#537)
- change: ci: bump zio-sbt to 0.8.7 and publish docs to npm with Trusted Publishing (drop NPM_TOKEN) (#531)
- change: docs: DataSource reference (#528)
- change: docs: add CompletedRequestMap page (#529)
- change: docs: caching and running queries (#525)
- change: docs: data source and query aspects in ZIO Query (#527)
- change: docs: error handling in ZIO Query (#526)
- change: docs: explain batching, pipelining and parallelism (#524)
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/zio-query 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 ed4159445d5f2dd8f883c294e5d4f0007468ce5d — 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.