Bank Adapter Changelog

Plane task: MHPAY-64 (MHPAY-BANK-004)

This document tracks version metadata for bank statement adapters. Every adapter exposes three semver-style versions in BankAdapterDescriptor:

Field	Bump when
AdapterVersion	Detection logic, descriptor capabilities, supported extensions, or adapter registration changes
ParserVersion	Any parser logic change (row parsing, date/amount rules, column mapping, balance validation in adapter)
NormalizerVersion	Counterparty extraction, normalization behavior, or transaction field mapping changes

Import pipeline persists detected versions on BankStatementImport, BankAdapterDetection, BankStatementImportQualityReport, and in quality report MetadataJson.

2026-06-30 — MHPAY-64 baseline

Introduced mandatory AdapterVersion, ParserVersion, NormalizerVersion on all registered adapters. Initial baseline for existing production adapters:

Bank	Format code	Adapter	AdapterVersion	ParserVersion	NormalizerVersion
CIMB	cimb-account-statement-summary-csv-v1	CorporateExplicitDebitCreditCsvAdapter	1.0.0	1.0.0	1.0.0
BCA	bca-account-portfolio-csv-v1	MultiAccountCrDbCsvAdapter	1.0.0	1.0.0	1.0.0
PERMATA	permata-transaction-inquiry-csv-v1	PermataCsvAdapter	1.0.0	1.0.0	1.0.0
PERMATA	permata-transaction-inquiry-text-v1	PermataTextAdapter	1.0.0	1.0.0	1.0.0
PERMATA	permata-mt940-like-v1	PermataMt940LikeAdapter	1.0.0	1.0.0	1.0.0

Rules for future changes

1. Parser change → increment ParserVersion on the affected adapter only; add a row to this changelog with date, task id, and summary.
2. Detection/descriptor change → increment AdapterVersion.
3. Counterparty/normalization change → increment NormalizerVersion.
4. Register new adapters in BankAdapterRegistry with all three versions set; unit test BankAdapterRegistry_AllDescriptors_ShouldExposeRequiredVersionMetadata fails if any version is missing.
5. Do not commit real bank files; use sanitized fixtures only.

2026-07-07 — Mandiri + BCA noise filter

Bank	Format code	Adapter	AdapterVersion	ParserVersion	NormalizerVersion	Notes
MANDIRI	mandiri-account-statement-csv-v1	MandiriAccountStatementCsvAdapter	1.0.0	1.0.0	1.0.0	New: semicolon CSV, Mandiri bank noise filter
BCA	bca-account-portfolio-csv-v1	MultiAccountCrDbCsvAdapter	1.0.0	1.0.0	1.0.1	Skip BIAYA ADM administrative fee rows