bondy-io/bondy
41.8
Weak · 15 November 2026
195.4k
lines of production code
Erlang
primary language
4
measurements over time
What this system is
Features
Add custom configuration examples for Bondy security and platform settings
The \examples/custom\_config\ directory now includes a \bondy.conf.template\ file that sets the security configuration file path and platform data directory, alongside a \security\_config.json\ file. This JSON file provides a comprehensive example of security realms, defining authentication methods (such as password, WAMP-CRA, cryptosign, and OAuth2), user accounts with credentials or authorized keys, groups, and access control sources and grants for both a production-style realm and a test realm.
_examples/custom\config · high confidence
Added bondy\_regulator OTP application for rate limiting
The new bondy\_regulator application provides a rate-limiting capability for the Bondy platform. It introduces a token-bucket algorithm implementation (bondy\_regulator\_rate\_limit) that manages request throughput using atomic counters, exposing API functions to create limits, check allowance, and wait for capacity. The app includes a standard OTP supervision tree (bondy\_regulator\_sup) to manage the rate-limiting state and is configured to depend on the resulto library. Also in this area: New SMTP bridge and DAG-CBOR test coverage.
_apps/bondy\_regulator, apps/bondy\regulator/src · high confidence
Expanded WAMP protocol support with new encodings and transports
The WAMP application now supports additional serialization formats and transport mechanisms. Users can utilize CBOR and batched variants of JSON, MessagePack, BERT, and Erlang terms for more efficient or specific payload encoding needs. Additionally, the system introduces support for Server-Sent Events (SSE) and HTTP long-polling as alternative transports to the standard WebSocket connection, enabling broader compatibility with different network environments and client capabilities.
_apps/bondy\wamp/include · high confidence
Initial project scaffolding and documentation
Added foundational repository files including a Docker ignore list, EditorConfig for consistent code formatting, the Apache 2.0 License, a Code of Conduct, and initial documentation (README, CHANGELOG, MIGRATION guide).
(repo-wide) · high confidence
Initial release of bondy\_cbor CBOR encoder/decoder
The bondy\_cbor OTP application is introduced, providing an implementation of the Concise Binary Object Representation (CBOR) data format as specified in RFC 8949. The core module exposes public API functions for encoding Erlang terms to CBOR (including a deterministic mode for sorted keys) and decoding CBOR binaries back to Erlang terms. This location also includes a comprehensive EUnit test suite validating the implementation against RFC 8949 Appendix A test vectors, as well as a benchmarking suite for comparing performance against MsgPack and Erlang's built-in JSON module.
_apps/bondy\cbor · high confidence
Introduce Bondy Broker Bridge for external event forwarding
The new \bondy\_broker\_bridge\ application provides a framework for forwarding WAMP events to external systems. It includes a manager that orchestrates subscriptions and a \mops\-based template engine for transforming event data. Shipped bridge implementations allow forwarding to Apache Kafka (\bondy\_kafka\_bridge\), sending SMS via AWS SNS (\bondy\_aws\_sns\_bridge\), and sending emails via SendGrid (\bondy\_sendgrid\_bridge\) and Mailgun (\bondy\_mailgun\_bridge\).
_apps/bondy\_broker\bridge/src · high confidence
Introduction of WAMP library with CBOR and partial payload support
The new bondy\_wamp OTP library (v1.3.0) provides WAMP message encoding and decoding, adding support for the CBOR binary format alongside existing JSON, MessagePack, BERT, and Erlang terms. It introduces partial encoding and decoding capabilities for JSON and CBOR, allowing large payloads to be handled efficiently by encoding only the message control elements while preserving the rest. The library also includes configuration management for serialization options, URI validation with strictness rules, and feature flag support for capability negotiation.
_apps/bondy\wamp/src · high confidence
Introduction of the Bondy Broker Bridge application
A new application, bondy\_broker\_bridge, has been added to the system to serve as a bridge between the Bondy platform and external message brokers. This component is configured to require Erlang/OTP R27.3.4 or later and integrates several dependencies to support specific bridging capabilities: 'brod' for Kafka connectivity, 'erlcloud' for AWS SNS, and 'email' for Sendgrid and Mailgun integrations. The inclusion of this app establishes the foundational infrastructure for routing events to these external services.
_apps/bondy\_broker\bridge · high confidence
New Docker configuration files for Bondy
Added three new configuration files for the Docker deployment: sys.config, which sets up SASL, Partisan, and OS Mon settings and includes user-defined configuration; vars.config, which defines platform directory paths under /bondy; and vm.args, which configures the Erlang VM node name and distributed cookie using environment variables, and loads additional arguments generated by cuttlefish and user-defined extra arguments.
config/docker · high confidence
New Dockerfiles for Bondy with hardened runtime and explicit port exposure
The deployment directory now includes two new Dockerfiles (Dockerfile and alpine.Dockerfile) that define the build and runtime environment for Bondy. The images are built using Erlang 27.3.4 and target Debian trixie-slim or Alpine 3.20. The runtime images are hardened by removing unnecessary packages like sudo and dnsutils to reduce the CVE attack surface, and they run as a dedicated non-root 'bondy' user. The configuration explicitly exposes ports 18080 through 18086 for API, admin, WAMP, and cluster services, and mounts /bondy/etc, /bondy/data, /bondy/log, and /bondy/tmp as volumes. Environment variables for node naming and distributed cookies are set with defaults, and the entrypoint runs Bondy in the foreground.
deployment · high confidence
New SMTP bridge and DAG-CBOR test coverage
The \bondy\_broker\_bridge\ app now includes a new \bondy\_smtp\_bridge\ module that enables sending email via \bondy\_mail\ asynchronously, allowing operators to configure SMTP relays and define email actions through the broker bridge specification system. Additionally, the \bondy\_cbor\ app adds a new \bondy\_cbor\_dag\_tests\ suite and associated fixtures to validate the DAG-CBR (IPLD) profile, ensuring correct round-trip encoding and strict decoding behavior for data structures like links, maps, and integers.
(repo-wide) · high confidence
New SMTP bridge and DAG-CBOR test coverage
The \bondy\_broker\_bridge\ app now includes a new \bondy\_smtp\_bridge\ module that enables sending email via \bondy\_mail\ asynchronously, allowing operators to configure SMTP relays and define email actions through the broker bridge specification system. Additionally, the \bondy\_cbor\ app adds a new \bondy\_cbor\_dag\_tests\ suite and associated fixtures to validate the DAG-CBR (IPLD) profile, ensuring correct round-trip encoding and strict decoding behavior for data structures like links, maps, and integers. Also in this area: Initial Fly.io deployment configuration for Bondy.
_apps/bondy\_broker\_bridge/test, apps/bondy\regulator/test · high confidence
New configurable Erlang VM arguments schema
A new schema file (vm\_args.schema) has been added to define and expose Erlang VM configuration options, allowing users to tune settings such as async thread stack sizes, IO poll threads, process and port limits, and CPU scheduler counts via the application's configuration interface.
schema/hidden · high confidence
New configuration files for the Bondy bridge component
This change introduces the initial configuration set for the Bondy bridge, including a comprehensive bondy.conf.template (covering startup, admin API, API gateway, and security settings), a sys.config for Partisan and OS monitoring, a vars.config defining default ports and paths, and a vm.args file for Erlang VM tuning. These files establish the baseline configuration structure for the bridge, replacing or supplementing previous ad-hoc configuration methods.
config/bridge · high confidence
New example configurations for API specs, broker bridge, OIDC, and security
Added example configuration files to demonstrate new capabilities: api\_spec.json defines a WAMP call API with OAuth2 and OIDC security defaults; broker\_bridge\_config.json configures a Kafka bridge subscription with metadata and deduplication support; oidc\_api\_spec.json provides a template for OIDC-based authentication; and security\_config.json.template sets up realm security with multiple auth methods (including cookie and OIDC RP) and user/group definitions.
examples/config · high confidence
New operational and configuration management tools
Added four new utility scripts to the \priv/tools\ directory to assist with deployment and maintenance: \console\_clean\ provides a shell interface to a running node for cleanup tasks; \db-repair.escript\ allows manual repair of specific EleveldB partitions; \replace-env-vars\ processes template files by substituting \${VARNAME}\ placeholders with actual environment variable values; and \validate-config\ ensures required configuration files like \bondy.conf\ and \vm.extra.args\ are present, automatically generating defaults or handling conflicts (such as moving duplicate config files to a \disabled\ directory) and sanitizing prohibited Erlang VM arguments.
priv/tools · high confidence
New production configuration files for Bondy release
Added three new configuration files for the production environment: sys.config defines core application settings for SASL, Partisan (including channel and peer service manager configuration), and OS Mon; vars.config establishes standard platform directory paths (bin, data, etc, lib, log, share, tmp); and vm.args configures the Erlang VM with distributed node naming and cookie settings via environment variables, while loading generated arguments from cuttlefish and user-defined extra arguments. These files collectively establish the baseline runtime configuration for the Bondy production release.
config/prod · high confidence
New release hooks for remote console, pre-start configuration, and status checks
Added three new shell scripts in the release hooks directory: \bondy\_remote\_console\ enables interactive remote shell access with configurable Erlang node names and distributed cookies; \pre\_start\ handles environment variable setup, exporting defaults for release directories and data/log/tmp paths (with hardcoded paths for Docker environments), and runs configuration validation and variable replacement before the application starts; \status\ provides a simple command to check the Bondy application status.
priv/hooks · high confidence
Removals
Removal of legacy Erlang header definitions
The \include/ramp.hrl\ file has been deleted, removing all previously defined Erlang type aliases (such as \uri()\, \id()\, \payload()\), message type constants (e.g., \HELLO\, \WELCOME\, \ERROR\), and record structures for the protocol's message types. This change eliminates the legacy header definitions from the codebase, requiring any remaining code to rely on alternative definitions or updated includes.
include · high confidence
Removal of legacy WAMP protocol implementation modules
The \src\ directory has had its core WAMP protocol implementation files deleted, including \ramp.erl\, \ramp\_app.erl\, \ramp\_id.erl\, \ramp\_packing.erl\, \ramp\_router.erl\, \ramp\_sup.erl\, and \ramp\_uri.erl\. This removes the previous session management, message packing/unpacking, ID generation, and URI validation logic from the application.
src · high confidence
Behavioural changes
11 commits (1 fix) modifying apps/bondy\_wamp
A change to existing behaviour in apps/bondy\_wamp — 11 commits (1 fix), 5 files: “add missing dependency”; “Pin git\_subdir deps to the 1.0.0 tag”; “update copyright notice”; and 8 more.
_apps/bondy\wamp · medium confidence · unverified
2 commits (0 fixes) modifying ebin
A change to existing behaviour in ebin — 2 commits, 2 files: “untracked”; “first drafts”.
ebin · medium confidence · unverified
2 commits (0 fixes) modifying proofs
A change to existing behaviour in proofs — 2 commits, 198 files: “update DB schema options and make boot fail if schema has unknown key (strict pre-start check)”; “Merge develop-bdb into develop”.
proofs · medium confidence · unverified
2 commits (1 fix) modifying (repo-wide)
A change to existing behaviour in (repo-wide) — 2 commits (1 fix), 87 files: “Rmeove unused experimental features and final bug fixes”; “Merge develop-bdb into develop”.
(repo-wide) · medium confidence · unverified
3 commits (0 fixes) modifying harness, jepsen/jepsen.bondy
A change to existing behaviour in harness, jepsen/jepsen.bondy — 3 commits, 48 files: “Rename the release and its binary to bondy-connect"”; “update DB schema options and make boot fail if schema has unknown key (strict pre-start check)”; “Merge develop-bdb into develop”.
harness, jepsen/jepsen.bondy · medium confidence · unverified
4 commits (0 fixes) modifying scripts
A change to existing behaviour in scripts — 4 commits, 3 files: “Rename the release and its binary to bondy-connect"”; “update DB schema options and make boot fail if schema has unknown key (strict pre-start check)”; “Merge develop-bdb into develop”; and 1 more.
scripts · medium confidence · unverified
42 commits (8 fixes) modifying apps/bondy\_router
A change to existing behaviour in apps/bondy\_router — 42 commits (8 fixs), 396 files: “Restart an OIDC provider worker when its realm's provider changes or goes”; “Charge HTTP rate limits before authentication”; “fix typo”; and 39 more.
_apps/bondy\router · medium confidence · unverified
6 commits (0 fixes) modifying deployment/fly
A change to existing behaviour in deployment/fly — 6 commits, 6 files: “fly example”; “Rename the release and its binary to bondy-connect"”; “update DB schema options and make boot fail if schema has unknown key (strict pre-start check)”; and 3 more.
deployment/fly · medium confidence · unverified
8 commits (0 fixes) modifying jepsen
A change to existing behaviour in jepsen — 8 commits, 21 files: “Pin git\_subdir deps to the 1.0.0 tag”; “Rename the release and its binary to bondy-connect"”; “update DB schema options and make boot fail if schema has unknown key (strict pre-start check)”; and 5 more.
jepsen · medium confidence · unverified
8 commits (1 fix) modifying apps/bondy\_db
A change to existing behaviour in apps/bondy\_db — 8 commits (1 fix), 98 files: “Pin git\_subdir deps to the 1.0.0 tag”; “upgrade to letest leveled (breaking change in disk format)”; “update DB schema options and make boot fail if schema has unknown key (strict pre-start check)”; and 5 more.
_apps/bondy\db · medium confidence · unverified
8 commits (2 fixes) modifying apps/bondy\_connect\_sdk, apps/bondy\_oplog
A change to existing behaviour in apps/bondy\_connect\_sdk, apps/bondy\_oplog — 8 commits (2 fixs), 346 files: “Pin git\_subdir deps to the 1.0.0 tag”; “update DB schema options and make boot fail if schema has unknown key (strict pre-start check)”; “Rmeove unused experimental features and final bug fixes”; and 5 more.
_apps/bondy\_connect\_sdk, apps/bondy\oplog · medium confidence · unverified
9 commits (1 fix) modifying apps/bondy\_mst
A change to existing behaviour in apps/bondy\_mst — 9 commits (1 fix), 73 files: “Pin git\_subdir deps to the 1.0.0 tag”; “Resolve the HTTP source IP for rate limiting only when a limit applies; Match MCP sources against the client address behind a trusted proxy”; “Test that a seal killed at any boundary leaves a store that reopens”; and 6 more.
_apps/bondy\mst · medium confidence · unverified
9 commits (2 fixes) modifying config
A change to existing behaviour in config — 9 commits (2 fixs), 3 files: “fix expiry”; “add args”; “add tool to generate ssl certs”; and 6 more.
config · medium confidence · unverified
Client-side rendering of Mermaid diagrams in documentation
The documentation now renders Mermaid diagrams directly in the browser using the mermaid.js library loaded from a CDN. This change adds a new JavaScript file that initializes the Mermaid library and processes code blocks marked with the 'mermaid' class to generate SVG visualizations, replacing the previous behavior where these diagrams were likely static images or required server-side processing.
doc/js · high confidence
Hardcoded Erlang VM configuration for named-node deployments
A new \vm.args\ file has been added to the \config/prod\_named\ profile, configuring the Erlang VM to use a hardcoded nodename (\bondy\) and cookie (\bondy\). This profile enforces strict distributed Erlang settings, such as disabling automatic connection and EPMD, to support deployments where node identity is fixed rather than dynamic. The configuration also sets specific VM flags for process limits, kernel polling, and async I/O, while deferring additional arguments to generated files.
_config/prod\named · high confidence
Introduction of Cuttlefish-based configuration schema
Bondy now uses a new Cuttlefish configuration schema (bondy.schema) to manage settings, replacing the previous configuration approach. This change introduces structured configuration for core components including the router, security realms, and startup behavior, while also adding dedicated schema files for new or enhanced features: Bridge Relay (bondy\_bridge\_relay.schema) for edge-to-core connections with TLS and keepalive controls, Broker Bridge (bondy\_broker\_bridge.schema) for Kafka integration, RPC Gateway (bondy\_rpc\_gateway.schema) for upstream service proxying with authentication and connection pooling, Logger (logger.schema) for detailed log handler and burst-control tuning, and OAuth2 (oauth2.schema) for token duration and grant settings. Users should review their bondy.conf files to align with the new option names and defaults, as some parameters have been renamed or reorganized.
schema · high confidence
New development configuration files for Bondy
The development environment now includes a new set of configuration files: bondy.conf.template, sys.config, vars.config, and vm.args. These files define the default settings for the Bondy application in development mode, including network ports, cluster settings, logging, and Erlang VM parameters. This change provides a structured way to configure the application for development, replacing or supplementing previous configuration methods.
config/dev · high confidence
Test coverage
Added comprehensive test suites for WAMP encoding, message handling, and URI validation; Added test environment configuration files.
Dependencies
Added E2E test dependencies and benchmarking tooling
The \bondy\_mcp\ test suite now includes a \package.json\ and lockfile for the \bondy-mcp-e2e\ environment, introducing the \@modelcontextprotocol/client\ (v2.0.0), \@modelcontextprotocol/conformance\ (v0.1.16), and \@modelcontextprotocol/sdk\ (v1.30.0) packages to support end-to-end testing. Additionally, a new \bench\ directory was added with a Mix project configuration and lockfile, bringing in the \benchee\ (v1.5.0) ecosystem (\benchee\_html\, \benchee\_json\) to enable performance benchmarking capabilities. Also in this area: Added benchmarking environment for CBOR implementation.
(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 49 → 42 (-6.7)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.
Lenses
- Code Health 33 → 21 (-11.6)
- Architecture 99 → 98 (-1.4)
- Maturity 71 → 77 (+5.8)
- Readiness 49 → 49 (+0.0)
- Security 63 → 61 (-2.5)
- Event-Driven 100 (new)
- Event Sourcing 58 (new)
- Performance 100 → 100 (+0.0)
Resolved (9)
- Change coupling: bondy_rbac_api.erl ↔ bondy_realm_api.erl (apps/bondy_router/src/bondy_rbac_api.erl)
- Medium CVE: EEF-[CVE redacted] (jepsen/bondy_mst_jepsen/rebar.lock)
- Medium CVE: [GHSA redacted] (rebar.lock)
- Members sharing a duplicated core (4 members, 50+ identical tokens) (jepsen/jepsen.bondymst/src/main/java/io/leapsight/jepsen/Utils.java)
- No ADRs found
- Secret: private-key (config/dev/security_config.json)
- Secret: private-key (config/dev/ssl/key.pem)
- Secret: private-key (examples/config/security_config.json)
- Secret: private-key (examples/custom_config/etc/security_config.json)
New (577)
- Change coupling: bondy_auth_password.erl ↔ bondy_wamp_protocol.erl (apps/bondy_router/src/bondy_auth_password.erl)
- Duplicated block (10 lines × 2) (apps/bondy_mst/src/bondy_mst.erl)
- Duplicated block (10 lines × 2) (apps/bondy_router/src/bondy_bridge_relay_client.erl)
- Duplicated block (10 lines × 2) (apps/bondy_router/src/bondy_broker.erl)
- Duplicated block (10 lines × 2) (apps/bondy_router/src/bondy_http_longpoll_handler.erl)
- Duplicated block (10 lines × 2) (apps/bondy_router/src/bondy_http_longpoll_handler.erl)
- Duplicated block (10 lines × 2) (apps/bondy_router/src/bondy_http_longpoll_handler.erl)
- Duplicated block (10 lines × 3) (apps/bondy_mst/src/bondy_mst_ets_store.erl)
- Duplicated block (10 lines × 3) (apps/bondy_oplog/src/bondy_oplog_crdt_aw_map.erl)
- Duplicated block (10–13 lines × 3) (jepsen/bondy_mst_jepsen/src/bondy_mst_jepsen_http_counter.erl)
- Duplicated block (11 lines × 2) (apps/bondy_router/src/bondy_dealer.erl)
- Duplicated block (11 lines × 2) (apps/bondy_router/src/bondy_oidc_handler.erl)
- Duplicated block (11 lines × 2) (apps/bondy_wamp/src/bondy_wamp_json.erl)
- Duplicated block (11–12 lines × 3) (apps/bondy_router/src/bondy_http_longpoll_handler.erl)
- Duplicated block (11–13 lines × 2) (apps/mops/src/mops.erl)
- Duplicated block (11–14 lines × 2) (apps/bondy_mst/src/bondy_mst_pack_writer.erl)
- Duplicated block (11–14 lines × 2) (apps/bondy_oplog/src/bondy_oplog_sync_scheduler.erl)
- Duplicated block (12 lines × 2) (apps/bondy_connect_sdk/src/bondy_connect_transport_longpoll.erl)
- Duplicated block (12 lines × 2) (apps/bondy_oplog/src/bondy_oplog_applier.erl)
- Duplicated block (12 lines × 2) (apps/bondy_oplog/src/bondy_oplog_instance.erl)
- …and 557 more
Changes since last survey
- 63 commits — 54 feature/other, 9 fixes
By area
- apps/bondy_router — 34 commits
- (root) — 12 commits
- (repo) — 10 commits
- .github/workflows — 2 commits
- doc/guides — 2 commits
- _plans/2026-08-14-dynamic-listeners-design.md — 1 commit
- apps/bondy_connect_sdk — 1 commit
- apps/bondy_oplog — 1 commit
Notable commits
- fix: Fix reported error
- fix: Fix the image workflow's tag trigger and arm64 labels
- fix: Fix two metrics that misreported: promise timeouts and AAE scheduler load
- fix: Rmeove unused experimental features and final bug fixes
- fix: URI validation fixes and matching performance improvements
- fix: error message fix
- fix: fix test
- fix: fix wrong location for test files
- fix: test fixes
- change: Test logins across a rolling restart and a cut-off node
- change: Answer 401 on gateway routes with an unenforced security scheme
- change: Answer 404 from OIDC login and callback for a missing realm or provider
- change: Answer an empty result from the group membership procedures
- change: Answer missing users and reserved names from the user and group procedures
- change: Apply sources to OIDC users without a local record
- change: Apply the realm's methods and sources on the verify route
- change: Authenticate API Gateway oidc routes with the realm's ticket cookie
- change: Charge HTTP rate limits before authentication
- change: Check a credential under its own method, and cookie as its carrier
- change: Check oidcrp before the OIDC login issues a ticket
- …and 43 more
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
bondy-io/bondy 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 15 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 d5df20074df7a1c80d408681e4f04210de63c8cb — the exact code this score is about.
- Scored under rubric-2026.11.4 — 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.65+preprod-3c33c1882dc1.