lineofflight/frankfurter
53.8
Adequate · 6 November 2026
14.8k
lines of production code
Ruby
primary language
4
measurements over time
What this system is
Features
Introduce materialized blended rate tables and parity verification
The library now materializes blended exchange rates into dedicated database tables (daily, weekly, and monthly) to serve queries from pre-computed data rather than computing blends on every request. This change introduces a new \BaseConversion\ class to handle provider rebasing and cross-currency bridging, a \Blender\ class that applies consensus outlier filtering and recency-weighted averaging, and a \PegAnchor\ module to correctly handle pegged currencies. A \BlendParity\ test harness is added to verify that the materialized table responses remain byte-identical to the live computation path, ensuring data consistency during the migration.
lib · high confidence
New CLI tools for interactive console, provider health monitoring, and job scheduling
The application now ships with three new executable scripts in the \bin\ directory to improve operational visibility and local development. \bin/console\ provides an interactive Ruby shell pre-loaded with core application models (DB, Rate, Currency, Provider) for debugging and exploration. \bin/provider\_health.rb\ acts as an automated monitor that checks provider status against the live API, creating or updating GitHub issues for stale providers or unknown currency codes to surface silent failures. \bin/schedule\ replaces the previous daemon approach with a script-based scheduler using Rufus::Scheduler, handling staggered backfills on startup, periodic re-blending of rates, and provider-specific cron jobs, all while respecting the database pool size.
bin · high confidence
New RuboCop cop to auto-correct early comment line wraps
A new custom RuboCop cop, \Style/CommentFill\, has been added to automatically detect and fix comment lines that wrap too early. When two consecutive full-line comments can be merged into a single line without exceeding the configured maximum length (default 120 characters), the cop autocorrects by moving the first word of the second comment to the end of the first, removing the now-empty second comment line if necessary. This improves code readability by reducing unnecessary line breaks in comments.
rubocop · high confidence
New provider adapter framework with initial bank integrations
The provider system has been refactored to use a dedicated adapter pattern, introducing a base \Provider::Adapters::Adapter\ class that standardizes HTTP fetching (via \http.rb\), error handling, and currency code resolution (including predecessor/successor mappings for redenominations). This change adds initial adapter implementations for numerous central banks, including AMCM, BAM, Banguat, BANREP, BANXICO, BBK (Deutsche Bundesbank), BCB, BCBO, BCC, BCCCD, BCCH, BCCR, BCEAO, BCP, BCRA, and BCT, enabling the system to fetch exchange rates from these new sources using a consistent, maintainable structure.
lib/provider · high confidence
Removals
Removal of legacy public landing page
The static \public/index.html\ file, which previously served as the main landing page for the Fixer API and included embedded Google Analytics tracking code, has been removed from the repository. Users will no longer be able to access this specific HTML entry point via the public directory.
public · high confidence
Behavioural changes
1 commit (0 fixes) modifying config
A change to existing behaviour in config — 1 commit, 1 file: “Bundle Sectigo EV R36 intermediate for BOMU (\#784)” (refs \#784). Also in this area: Add missing TLS intermediates to fix certificate verification failures.
_config/ca\bundles · medium confidence · unverified
Database schema overhaul and historical data corrections
The database schema has been significantly restructured to support more accurate rate data and provider management. The \rates\ table now stores separate \bid\ and \ask\ components alongside a virtual \rate\ column, replacing the previous single \rate\ column, and includes a \source\ column to track the provider. A new \providers\ table manages provider metadata, including a \publish\_schedule\ for release cadence and a \frequency\ field to distinguish between daily, monthly, and quarterly observations. New tables for \weekly\_rates\ and \monthly\_rates\ provide pre-computed rollups for grouped queries, while \currencies\ and \currency\_coverages\ tables track currency validity periods and provider coverage. Additionally, a series of migrations corrects historical data issues, such as relabeling predecessor currencies (e.g., old manat to AZM, old ruble to RUR), normalizing SDR to XDR codes, and fixing provider-specific labeling errors to ensure data integrity across the system.
db/migrate · high confidence
Deprecate v1 API and introduce v2 with new endpoints and streaming support
The v1 API is now marked as deprecated and returns standard deprecation headers (RFC 9745) pointing users to the v2 successor endpoints. The new v2 API introduces a redesigned response structure with one record per currency pair, adds dedicated endpoints for provider details (/providers) and currency metadata (/currency/:code), and supports streaming responses in JSON, CSV, and NDJSON formats for date-range queries to improve performance on large exports.
lib/versions · high confidence
Migrate web server from Unicorn to Puma
The application's web server configuration has switched from Unicorn to Puma. The previous Unicorn configuration file has been removed and replaced with a new Puma configuration that allows tuning the number of worker processes and threads via environment variables, enables application preloading, and ensures database connections are properly disconnected before forking workers.
config · high confidence
New rake tasks for data maintenance, testing, and code quality
The application now includes a comprehensive set of Rake tasks in lib/tasks to manage data lifecycle and development workflows. Users can rebuild materialized blend tables (daily, weekly, monthly) and verify data parity, purge invalid future-dated rates, and backfill provider data with parallelized workers. The test suite has been refactored to run in parallel using SQLite, and a default task now automatically runs RuboCop linting, database migrations, seeding, and specs.
lib/tasks · high confidence
Rebrand to Frankfurter and migrate to Puma, SQLite, and Roda
The application is rebranded as Frankfurter, replacing the previous Fixer.io identity. The web server has switched from Unicorn to Puma, and the database backend has migrated from PostgreSQL to SQLite. The framework layer has been refactored from Sinatra to Roda, with the main application entry point consolidated into \lib/app.rb\. Deployment is now managed via a multi-stage Dockerfile targeting Ruby 4.0.7, and the boot process includes consolidated TLS certificate handling for provider connectivity.
(repo-wide) · high confidence
Refactor v1 query handling and introduce currency name lookups
The v1 API layer has been restructured to improve query parsing and data availability. A new \Query\ class now centralizes the parsing of request parameters (such as \from\, \to\, \amount\, and date ranges) into a standardized hash, replacing previous inline logic. Additionally, a new \CurrencyNames\ component has been added to the v1 namespace, which fetches available currency codes from recent ECB rates and maps them to their human-readable names using the \Money\ gem, making this metadata accessible to API consumers.
lib/versions/v1 · high confidence
Skills directory converted to a symbolic link
The .claude/skills path is now a symbolic link pointing to ../.agents/skills, consolidating skill definitions under the .agents directory structure.
.claude · high confidence
V2 rate query engine with materialized blends and concurrency controls
The V2 API now uses a new \RateQuery\ engine that serves range queries from materialized blended rate tables for improved performance, while falling back to live computation when provider metadata is requested or the materialized table is not yet ready. The implementation introduces concurrency limits via \HeavySlots\ to cap concurrent heavy range computations, enforces date validation (YYYY-MM-DD format), and supports CSV downloads named after the query parameters. It also handles carry-forward logic for missing dates, anchors rates to a USD pivot, and exposes provider details when explicitly requested via the \expand=providers\ parameter.
lib/versions/v2 · high confidence
Test coverage
Added comprehensive test coverage for provider adapters; Added test coverage for V1 versioning components; Added test coverage for core API, base conversion, and blend maintenance logic; Added test coverage for v1 and v2 API endpoints; Added tests for V2 rate blending, coverage, and provider handling; Added tests for the new CommentFill cop.
Dependencies
Major dependency overhaul and framework migration
The application has undergone a significant dependency update, migrating the web framework from Sinatra to Roda and replacing the Unicorn web server with Puma. The database driver has switched from PostgreSQL (pg) to SQLite3, and JSON generation now utilizes the Oj and Ox libraries instead of yajl-ruby. Additional changes include upgrading Rack to version 3.2.7, adding the http gem for HTTP requests, and introducing a suite of Rubocop linters (minitest, performance, rake, sequel) for development and testing.
(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 55 → 54 (-0.8)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 74 → 74 (-0.0)
- Architecture 73 → 72 (-1.2)
- Maturity 56 → 59 (+2.7)
- Readiness 57 → 57 (-0.1)
- Security 46 → 43 (-2.3)
- Domain Modelling 100 → 100 (+0.0)
Resolved (4)
- Further sole-owners (lower concentration)
- Hotspot: lib/provider/adapters/imf.rb (lib/provider/adapters/imf.rb)
- Hotspot: lib/provider/adapters/mas.rb (lib/provider/adapters/mas.rb)
- Off-boarding risk: anonymized user #1
New (8)
- Duplicated block (10 lines × 2) (lib/provider/adapters/jvcea.rb)
- JVCEA.parse_row (cyclomatic 17) (lib/provider/adapters/jvcea.rb)
- Off-boarding risk: anonymized user #1
- Off-boarding risk: anonymized user #2
- Outdated: csv
- Outdated: nokogiri
- Outdated: rack-test
- Outdated: vcr
Changes since last survey
- 16 commits — 16 feature/other, 0 fixes
By area
- (root) — 4 commits
- lib/versions — 2 commits
- spec/vcr_cassettes — 2 commits
- (repo) — 1 commit
- .github/workflows — 1 commit
- config/ca_bundles — 1 commit
- db/seeds — 1 commit
- lib/base_conversion.rb — 1 commit
- lib/provider — 1 commit
- spec/provider — 1 commit
- spec/versions — 1 commit
Notable commits
- change: Add CM and JVCEA crypto providers (#785)
- change: Add CME reference rate crypto assets to CM and SOL to JVCEA (#787)
- change: Add ESTV as a crypto provider (#772)
- change: Bump docker/login-action from 4.6.0 to 4.7.0 in the actions group (#778)
- change: Bump docker/login-action from 4.6.0 to 4.7.0 in the actions group (#779)
- change: Bundle Sectigo EV R36 intermediate for BOMU (#784)
- change: Cap /v2/currencies and /v2/currency/:code cache TTL at 1 hour (#788)
- change: Keep five significant figures below 1 (#775)
- change: Match BOA archive with a prefixed name
- change: Parse BI rates from embedded chart data
- change: Return null for missing ISO numeric codes (#777)
- change: Sign provider requests with Web Bot Auth
- change: Upgrade Ruby to 4.0.8
- change: Upgrade Ruby to 4.0.9
- change: Use median for cross-provider fallback bridge in BaseConversion (#786)
- change: Write small rates as plain decimals (#776)
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
lineofflight/frankfurter 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 ef50157b76afa247a4272771369010f4909162b4 — 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.2+preprod-5c4e66d9318b.