BeamBridge / backend /catalog.py
ql6's picture
Publish BeamBridge v2 Platform + Full Python Source & Empirical Ledger
7eeb78f verified
Raw History Blame Contribute Delete
7.06 kB
"""
BeamBridge Real GitHub Repository Catalog & MCP Tool Specifications.
Every repository corresponds to an untouched open-source Python repository cloned from GitHub
in `real_github_repos/` and modernized into a standalone Anthropic MCP v2 server in `modernized_mcp/`.
"""
from __future__ import annotations
from typing import Any
REPO_CATALOG: dict[str, dict[str, Any]] = {
"py_moneyed": {
"id": "py_moneyed",
"code": "GH-4c90ed5",
"name": "limist/py-moneyed",
"github_url": "https://github.com/limist/py-moneyed",
"git_sha": "4c90ed5",
"sector": "Treasury & ISO-4217 Money",
"compliance_regime": "ISO-4217 Sub-Unit Ledger · ROUND_HALF_EVEN",
"status_badge": "Certified",
"badge_tone": "mint",
"headline": "Multi-currency ISO-4217 numeric & sub-unit treasury ledger, banker's rounding, and remainder-exact pro-rata allocation.",
"legacy_pain": (
"Chunked RAG retrieves `__init__.py` without `classes.py`, missing `Money.round()` defaulting `ndigits=0` "
"(whole currency units) and `get_amount_in_sub_unit()` truncating via `int()` (92.5% chunked vs 100.0% whole-repo)."
),
"mcp_tools": [
{
"name": "inspect_and_round_money",
"title": "ISO-4217 Money Sub-Unit & Banker's Rounder",
"sample_args": {"amount_str": "1234.567", "currency_code": "BHD", "ndigits": 3},
},
{
"name": "pro_rata_subunit_split",
"title": "Zero-Leakage Sub-Unit Pro-Rata Splitter",
"sample_args": {"amount_str": "100.00", "currency_code": "USD", "weights": [1, 1, 1]},
},
{
"name": "convert_and_sum_ledger",
"title": "Multi-Currency Treasury Ledger Aggregator",
"sample_args": {
"entries": [{"amount": "100.00", "currency": "USD"}, {"amount": "250.00", "currency": "EUR"}],
"target_currency": "SAR",
"rates_to_target": {"USD": "3.75", "EUR": "4.0625"},
},
},
],
},
"price_parser": {
"id": "price_parser",
"code": "GH-6718bfe",
"name": "scrapinghub/price-parser",
"github_url": "https://github.com/scrapinghub/price-parser",
"git_sha": "6718bfe",
"sector": "Global Procurement & Pricing",
"compliance_regime": "Multi-Locale Decimal & Currency Extraction",
"status_badge": "Certified",
"badge_tone": "lavender",
"headline": "Global procurement price & symbol parser handling European comma decimals, Swiss apostrophes, Indian lakhs, and range feeds.",
"legacy_pain": (
"Chunked RAG truncates `_currencies.py` and bottom regex rules in `parser.py`, misparsing `R$`, `zł`, Swiss `1'250.50`, "
"`Free!` (`Decimal('0')`), and `decimal_separator` overrides (72.5% chunked vs 100.0% Beam-1.0 whole-repo)."
),
"mcp_tools": [
{
"name": "parse_procurement_price",
"title": "Multi-Locale Price & Currency Symbol Parser",
"sample_args": {"raw_text": "Total: 1.299,95 € (incl. VAT)", "currency_hint": None, "decimal_separator": None},
},
{
"name": "compute_invoice_line_quote",
"title": "Procurement Line Quote & Discount Engine",
"sample_args": {"raw_unit_price": "CHF 1'250.50", "quantity": 4, "raw_discount": "CHF 200.00"},
},
{
"name": "audit_price_feed_batch",
"title": "Catalog Price Feed Batch Auditor",
"sample_args": {"raw_items": ["$19.99", "€ 30,01", "Free!", "Contact sales"]},
},
],
},
"schwifty": {
"id": "schwifty",
"code": "GH-7462c6e",
"name": "mdomke/schwifty",
"github_url": "https://github.com/mdomke/schwifty",
"git_sha": "7462c6e",
"sector": "Core Banking IBAN & SWIFT/BIC",
"compliance_regime": "ISO-13616 IBAN Mod-97 · ISO-9362 SWIFT/BIC",
"status_badge": "Certified",
"badge_tone": "mint",
"headline": "ISO-13616 IBAN decomposition, country BBAN bank/account slicing, Mod-97 check-digit generation, and ISO-9362 SWIFT/BIC inspection.",
"legacy_pain": (
"Chunked RAG misses `iban_registry/generated.json` & `overwrite.json`, failing country BBAN offsets where branch/check digits "
"sit between `bank_code` and `account_code` in GB, FR, IT, and ES (60.0% chunked vs 100.0% whole-repo)."
),
"mcp_tools": [
{
"name": "validate_and_decompose_iban",
"title": "ISO-13616 IBAN Validator & BBAN Decomposer",
"sample_args": {"raw_iban": "GB29 NWBK 6016 1331 9268 19"},
},
{
"name": "generate_iban_from_bban",
"title": "ISO-13616 IBAN Mod-97 Generator",
"sample_args": {"country_code": "DE", "bank_code": "37040044", "account_code": "0532013000"},
},
{
"name": "inspect_swift_bic",
"title": "ISO-9362 SWIFT/BIC Head-Office & Country Inspector",
"sample_args": {"raw_bic": "DEUTDEFF500"},
},
],
},
"python_stdnum": {
"id": "python_stdnum",
"code": "GH-006192e",
"name": "arthurdejong/python-stdnum",
"github_url": "https://github.com/arthurdejong/python-stdnum",
"git_sha": "006192e",
"sector": "Securities, Fedwire & EU VAT",
"compliance_regime": "ISIN/CUSIP/SEDOL/LEI/FIGI · IRS EIN · EU VAT",
"status_badge": "Certified",
"badge_tone": "gold",
"headline": "Global securities identifiers (ISIN, CUSIP, SEDOL, LEI, FIGI), US Federal Reserve RTN & IRS EIN campus validation, and EU VAT check digits.",
"legacy_pain": (
"Chunked RAG misses `us/ein.dat` unassigned IRS campus prefixes (`07`, `00`), Federal Reserve `rtn.py` routing district bands, "
"and country-specific ISO-7064 Mod 11,10 (`DE`) / Mod-97 (`FR`, `NL`, `BE`) VAT rules (60.0% chunked vs 100.0% whole-repo)."
),
"mcp_tools": [
{
"name": "validate_securities_id",
"title": "Global Securities ID Validator (ISIN/CUSIP/SEDOL/LEI/FIGI)",
"sample_args": {"scheme": "ISIN", "raw_code": "US0378331005"},
},
{
"name": "validate_us_routing_or_ein",
"title": "US Fedwire ABA RTN & IRS EIN Validator",
"sample_args": {"id_type": "RTN", "raw_number": "021000021"},
},
{
"name": "validate_eu_vat_number",
"title": "Multi-Country EU VAT Checksum Engine",
"sample_args": {"raw_vat": "DE 136 695 976"},
},
],
},
}