softwaremill/ox
58.8
Adequate · 6 November 2026
8.8k
lines of production code
Scala
primary language
4
measurements over time
What this system is
Features
Add InheritableMDC for scoped MDC propagation
Users can now propagate MDC values across forked threads using the new InheritableMDC API. After calling InheritableMDC.init, methods like supervisedWhere and unsupervisedWhere allow setting MDC key-value pairs that are automatically inherited by any forks created within the scope, while standard MDC.put calls remain thread-local.
mdc-logback · high confidence
Add cron-based scheduling for task repeats
Users can now schedule repeated tasks using standard cron expressions via the new \CronSchedule\ API. This allows tasks to run at specific times (e.g., every second, daily) rather than fixed intervals, with support for parsing cron strings directly or using pre-parsed expressions.
cron · high confidence
Add flow-json module for streaming NDJSON and JSON array parsing and rendering
The new flow-json module provides extension methods on Flow\[Chunk\[Byte\]\] to parse UTF-8 NDJSON (one JSON value per line) and top-level JSON arrays, as well as methods to render flows of values into NDJSON or JSON array byte streams. Parsing supports configurable record size limits, handles BOMs and CRLF line endings, and uses jsoniter for decoding. Rendering ensures NDJSON output is non-indented and wraps array elements with appropriate separators.
flow-json · high confidence
Initial documentation build infrastructure and content
The \generated-doc/out\ directory now contains the complete source and configuration for the Ox project documentation. This includes the Sphinx configuration (\conf.py\) with the \sphinx\_rtd\_theme\ and \sphinx\_llms\_txt\ extension, the main entry point (\index.md\) and a comprehensive API tour (\tour.md\) covering concurrency, streaming, and resiliency features, along with build scripts (\Makefile\, \make.bat\, \watch.sh\) and environment definitions (\.python-version\, \flake.nix\) to support local documentation generation.
generated-doc/out · high confidence
Integration with Reactive Streams Publisher
The flow-reactive-streams module now provides bidirectional conversion between Ox Flows and the Reactive Streams Publisher interface. Users can convert a Flow into a Reactive Streams Publisher using the new \toReactiveStreamsPublisher\ extension method, and create a Flow from a Reactive Streams Publisher using \FlowReactiveStreams.fromPublisher\, enabling interoperability with libraries that rely on the \org.reactivestreams\ API.
flow-reactive-streams · high confidence
Introduce Flow API for direct-style concurrency streaming
Adds a new \Flow\ abstraction in \core/src/main/scala/ox/flow\ that provides a lazy, composable pipeline for asynchronous streaming. This API allows users to create flows from various sources (iterables, channels, files, reactive publishers) and transform them using combinators like \map\, \buffer\, and \groupBy\. It includes specific operators for running flows to collections (\runToList\, \runToSet\, \runToMap\), handling I/O (\runToFile\, \runToInputStream\, \fromFile\, \fromInputStream\), and integrating with the JDK \Flow.Publisher\ standard via \toPublisher\ and \fromPublisher\.
core/src/main/scala/ox/flow · high confidence
Introduce Kafka integration with Flow-based streaming and offset management
This change adds a new Kafka integration module to the product, providing a set of Scala components for consuming and producing messages via the \ox.flow\ API. It introduces \KafkaFlow\ for subscribing to topics and emitting records as a stream, \KafkaStage\ for mapping and publishing producer records with optional offset committing, and \KafkaDrain\ for running side-effecting publish and commit operations. The implementation includes \KafkaConsumerWrapper\ to handle thread-safe consumer interactions and a \docker-compose.yml\ file to facilitate local testing with Zookeeper and Kafka. Manual benchmark scripts are also included to compare performance against Pekko Kafka connectors.
kafka · high confidence
Introduces core concurrency primitives and application entry point
This release adds the foundational building blocks for the library, including the \Chunk\ collection for efficient multi-array data handling, the \ErrorMode\ trait to support flexible application error reporting (via \Either\ or union types), and the \OxApp\ trait for structured application entry points with proper shutdown and exception handling. It also introduces the \Channel\ API backed by the \jox\ library, providing \Source\ and \Sink\ interfaces with non-blocking operations like \trySend\ and \tryReceive\, as well as the \FlowOps\ class which brings streaming operators such as \batch\, \conflate\, and \buffer\ to the \Flow\ API. Additionally, resilience patterns are introduced with \AdaptiveRetry\ for token-bucket-based retry logic and \CircuitBreaker\ for dropping or limiting operations based on failure rates.
repository · high confidence
New rate limiter and refactored retry API in the resilience package
The \ox.resilience\ package now includes a new \RateLimiter\ with multiple algorithms (fixed window, sliding window, leaky bucket) that can account for either operation start time or full duration, offering \runBlocking\ and \runOrDrop\ modes. Additionally, the retry API has been refactored: \RetryConfig\ now uses \afterAttempt\ instead of the previous \onRetry\ callback, and the underlying scheduling mechanism has been replaced with an interval-list based approach to manage retry intervals more precisely.
core/src/main/scala/ox/resilience · high confidence
New scheduling and repeat APIs with configurable sleep modes
The scheduling module introduces new \scheduled\ and \repeat\ functions along with their configuration classes (\ScheduledConfig\, \RepeatConfig\) and supporting types (\Jitter\, \SleepMode\). Users can now schedule operations with explicit control over timing via \SleepMode.StartToStart\ (interval from previous start) or \SleepMode.EndToStart\ (interval from previous end), and configure repetition logic using \RepeatConfig\ which allows customizing the schedule and defining when to stop based on results. The implementation uses an interval-list based approach for scheduling.
core/src/main/scala/ox/scheduling · high confidence
OpenTelemetry context propagation for virtual threads
The new PropagatingVirtualThreadFactory ensures that OpenTelemetry context is automatically propagated to newly created virtual threads. When a thread is spawned, the current context is captured and made current for the duration of the task, and the scope is properly closed in a finally block to prevent resource leaks, allowing distributed tracing to function correctly across virtual thread boundaries.
otel-context · high confidence
Project initialization and tooling configuration
The repository has been initialized with the Ox library (version 1.0.9) for Scala 3 on the JVM, including an Apache 2.0 license, a README with usage examples, and a Context7 configuration for AI coding assistants. Build tooling is configured with Scalafmt 3.11.5 (including Scala 3 syntax rules), Scala Steward for dependency updates, and ReadTheDocs for documentation hosting, while the previous version.sbt file was removed.
(repo-wide) · high confidence
Structured concurrency primitives and resource management
The core library introduces structured concurrency capabilities, including \supervised\, \unsupervised\, and \supervisedError\ scopes, along with corresponding fork types (\fork\, \forkUser\, \forkUnsupervised\, \forkCancellable\) and resource management via \resourceScope\ and \Ox\ traits. It adds utilities for handling uninterruptible blocking operations (\abandonOnInterrupt\, \abandonOnInterruptReads\, \abandonOnInterruptWrites\), parallel collection processing (\mapPar\, \filterPar\, \collectPar\, \foreachPar\), and CPU-intensive tasks (\computeIntensive\). The release also includes control flow helpers (\forever\, \repeatWhile\, \repeatUntil\, \never\, \cede\, \checkInterrupt\), an \either\ block for error handling, fork-local variables (\ForkLocal\), and integration support via \inScopeRunner\.
core/src/main/scala/ox · high confidence
Removals
Removal of Warp structured concurrency library
The Warp library, which provided structured concurrency primitives such as \Warp.fork\, \Warp.uninterruptible\, and \FiberLocal\ for managing scoped values and virtual threads, has been removed from the JDK module. This deletion eliminates the ability to create and manage structured concurrent tasks and fiber-local state within this module.
jdk · high confidence
Behavioural changes
1 commit (0 fixes) modifying otel-tracing, repository
A change to existing behaviour in otel-tracing, repository — 1 commit, 5 files: “OxTelemetry - integration of ox, ox flows with OpenTelemetry (\#527)” (refs \#527).
otel-tracing · medium confidence · unverified
Add Scarf analytics tracking to documentation
The documentation now includes a Scarf tracking pixel on every page to collect usage analytics. This is implemented by injecting a specific image tag into the footer template, which loads a pixel from static.scarf.sh with a unique project ID.
_doc/\_templates, generated-doc/out/\templates · high confidence
Documentation build infrastructure and content structure
The documentation site has been restructured with a new 'Tour of Ox' featured on the front page and a comprehensive table of contents covering concurrency, streaming, scheduling, and integrations. The build system now uses Sphinx with the Read the Docs theme, supports both Markdown and reStructuredText, and includes a Python 3.12 development shell via Nix flakes. Additionally, the site now generates llms.txt files for AI coding assistants and provides a watch script for live development.
doc · high confidence
Improved error messaging for invalid fork creation
When attempting to create a fork outside of a valid concurrency scope, users now receive a specific error message identifying the unrelated thread that attempted the operation, rather than a generic scope-tree violation. This change is implemented in the internal ThreadHerd and ScopeContext components, which now track the current scope context per thread to provide clearer diagnostics for this user error.
core/src/main/scala/ox/internal · high confidence
Introduction of type-safe channel capacity and union-based closed-state handling
The channel API now uses a type-safe \BufferCapacity\ context parameter to control buffer sizes for new channels and flow transformations, defaulting to 16 when not explicitly provided. Additionally, channel operations now return union types (e.g., \T \| ChannelClosed\) with extension methods like \orThrow\, \toEither\, and \toTry\ to handle closed states more safely and expressively.
core/src/main/scala/ox/channels · high confidence
Test coverage
Added comprehensive test coverage for channels, actors, and source operations; Added comprehensive test coverage for core concurrency and utility features; Added test coverage for resilience and scheduling primitives; Added test utilities for timing, counting, and tracing; Added tests for Flow IO operations, alsoTo/alsoToTap, and batching operators; Added tests for Flow-to-Reactive Streams integration.
Dependencies
Migrate to sbt 2.0.9 and update core dependencies
The build system has been upgraded to sbt 2.0.9 and the sbt-softwaremill plugin 3.0.1, which restructures the project into multiple modules (core, kafka, mdc-logback, flow-reactive-streams, flow-json, cron, otel-context) and updates the Scala version to 3.3.8. Key dependency versions have been updated, including logback-classic to 1.6.5, slf4j-api to 2.0.20, scalatest to 3.2.20, kafka-clients to 4.3.1, embedded-kafka to 4.3.1, pekko-stream to 1.7.0, opentelemetry-api to 1.66.0, and cron4s-core to 0.8.2. The project name has changed from 'warp' to 'ox', and the organization to 'com.softwaremill.ox'.
(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 60 → 59 (-0.9)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 61 → 61 (-0.0)
- Architecture 92 → 88 (-4.0)
- Maturity 64 → 63 (-0.7)
- Readiness 52 → 52 (+0.0)
- Security 78 → 70 (-8.7)
Resolved (12)
- Consequences are real but thin: they note a type-safe split of Ox capability into OxUnsupervised and Ox with no trade-offs (e.g. loss of unsupervised flexibility or the new flag) and only one sentence on why supervised is kept (doc/adr/0007-supervised-unsupervised-scopes.md)
- Consequences/trade-offs are absent despite a clear context and decision (doc/adr/0008-scheduled-repeat-retry.md)
- Consequences/trade-offs are absent despite a strong context and an explicit decision (doc/adr/0003-why-source-operators-do-not-throw.md)
- Off-boarding risk: anonymized user #1
- Orphaned file (core/src/main/scala/ox/resilience/CircuitBreaker.scala)
- Orphaned file (core/src/main/scala/ox/resilience/CircuitBreakerConfig.scala)
- Orphaned file (core/src/main/scala/ox/resilience/CircuitBreakerStateMachine.scala)
- Orphaned file (core/src/main/scala/ox/resilience/DurationRateLimiterAlgorithm.scala)
- Orphaned file (core/src/main/scala/ox/resilience/RateLimiter.scala)
- Orphaned file (core/src/main/scala/ox/resilience/StartTimeRateLimiterAlgorithm.scala)
- Orphaned files with no living knowledge
- Outdated: org.apache.kafka:kafka-clients
New (16)
- ADR has no Consequences section (doc/adr/0001-error-propagation-in-channels.md)
- ADR has no Consequences section (doc/adr/0002-retries.md)
- ADR has no Consequences section (doc/adr/0003-why-source-operators-do-not-throw.md)
- ADR has no Consequences section (doc/adr/0004-channels-safe-unsafe-operations.md)
- ADR has no Consequences section (doc/adr/0005-application-errors.md)
- ADR has no Consequences section (doc/adr/0006-actors.md)
- ADR has no Consequences section (doc/adr/0008-scheduled-repeat-retry.md)
- Classify ADR enforcement: 1. Error propagation in channels (doc/adr/0001-error-propagation-in-channels.md)
- Classify ADR enforcement: 2. Retries (doc/adr/0002-retries.md)
- Classify ADR enforcement: 3. Why source operators do not throw (doc/adr/0003-why-source-operators-do-not-throw.md)
- Classify ADR enforcement: 4. Channels: safe/unsafe Operations (doc/adr/0004-channels-safe-unsafe-operations.md)
- Classify ADR enforcement: 5. Application errors (doc/adr/0005-application-errors.md)
- Classify ADR enforcement: 6. Actors (doc/adr/0006-actors.md)
- Classify ADR enforcement: 7. Supervised & unsupervised scopes (doc/adr/0007-supervised-unsupervised-scopes.md)
- Classify ADR enforcement: 8. Retries (doc/adr/0008-scheduled-repeat-retry.md)
- Off-boarding risk: anonymized user #1
Changes since last survey
- 10 commits — 10 feature/other, 0 fixes
By area
- (root) — 7 commits
- project/build.properties — 2 commits
- otel-tracing/src — 1 commit
Notable commits
- change: OxTelemetry - integration of ox, ox flows with OpenTelemetry (#527)
- change: Update jsoniter-scala-core, ... to 2.41.7 (#539)
- change: Update jsoniter-scala-core, ... to 2.42.0 (#541)
- change: Update jsoniter-scala-core, ... to 2.42.1 (#543)
- change: Update jsoniter-scala-core, ... to 2.42.2 (#545)
- change: Update kafka-clients to 4.3.2 (#540)
- change: Update kafka-clients to 4.4.0 (#535)
- change: Update logback-classic to 1.6.6 (#542)
- change: Update sbt to 2.0.11 (#538)
- change: Update sbt to 2.0.12 (#544)
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
softwaremill/ox 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 6 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 bb23e4cfddae45143a0937b7803430f34b511d50 — 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-60d1b390edf0.