dsh-bankrec

dsh plugin --profile web add dsh-bankrec

<div align="center">

dsh-bankrec

Official repository. The only official repository of this package, maintained by PerryLink. Same-name repositories under other accounts are not affiliated. Apache-2.0.











Bank statement ingest, CAMT.053/MT940 reconciliation and 3-sheet workpaper.

Status: alpha / public-synthetic / partial / not counted / not GA. No customer evidence, customer data, or production-readiness claim.

[English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)

dsh plugin --profile <profile> add dsh-bankrec

</div>

⭐ If this helps, a star makes it easier for the next person to find it. Nothing is gated behind it.

Workflow: local input → plugin → local output. No model call is required.

Real local test run; no model or network call.

Install

Install and verify:

dsh plugin --profile <profile> add dsh-bankrec
dsh --profile <profile> --dump-config | grep dsh-bankrec

Uninstall:

dsh plugin --profile <profile> remove dsh-bankrec

Install channels

npm is the recommended channel; the others are for pinning or offline use.

• npm (recommended): dsh plugin --profile <profile> add dsh-bankrec
• git channel: dsh plugin --profile <profile> add github:PerryLink/dsh-bankrec
• tarball: pnpm pack then dsh plugin --profile <profile> add ./dsh-bankrec-<version>.tgz
• 1024 store: npm i -g dsh1024 then dsh1024 plugin --profile <profile> add dsh-bankrec

What it does

Bank statement ingest, CAMT.053/MT940 reconciliation and 3-sheet workpaper. Runs locally on DeepSeek Harness. The table below is the exact tool surface; the examples use the real command surface.

Input and output stay local; nothing is uploaded.

Tools

Tool names and descriptions are kept in English to match the runtime output.

Tool · Purpose · Risk

bankrec.ingest · Ingest bank CSV/GL rows · R1 local write

bankrec.ingest_camt · Ingest CAMT.053 XML · R1 local write

bankrec.ingest_mt940 · Ingest MT940 statements · R1 local write

bankrec.reconcile_camt · Reconcile CAMT opening + entries = closing; require account_id when ambiguous · R0

bankrec.match · 1:1 match bank rows to GL rows · R0

bankrec.export · Export a 3-sheet xlsx: Bank / GL / Matches · R1 local write

Quick start

dsh plugin --profile <profile> add dsh-bankrec
dsh --profile <profile> --dump-config | grep dsh-bankrec

Examples

Fixture-backed example

Input: fixtures/public/mit-camt/example-camt053-a.xml

Command: pnpm test

Acceptance row:

req_id · metric · threshold · actual · pass · source · counted

SKU-06-A01 · 流水解析（30） · 30/30 · 30 · true · public/synthetic · false

This is a fixture-backed acceptance row, not a customer run; no output is invented.

Limits

• Public/synthetic only; no customer data or customer evidence.
• Alpha/partial, not counted, no GA or production-readiness claim.
• No model or network call unless a tool explicitly says so.
• The exact per-tool boundaries are in the table and ACCEPTANCE.csv.

Public sample

Public/synthetic fixtures live in fixtures/; ACCEPTANCE.csv records the public checks with counted=false.

Development

pnpm install --frozen-lockfile
pnpm build && pnpm lint && pnpm typecheck && pnpm test

Compatibility

Surface · Status

Harness · dsh >=0.2.1-rc.3 <0.3.0

Node · >=24.9.0 <25

Platforms · All; local files only

Data · No network, no model call, no upload

Permissions & data

• Runs locally; no network, no model call, no upload.
• Public/synthetic fixtures only; no customer data, no customer evidence.
• Alpha/partial; not counted, no GA or production-readiness claim.

Related work

Sibling packages and family indexes: dsh-einvoice · dsh-ap-three-way · dsh-travel-recon · dsh-finops-suite

Related checkers

Each entry is a separate package with its own rule pack and version; install only the ones you need.

Package · Why it is relevant

dsh-excel-reconcile · Generic two-table reconciliation by key and tolerance.

dsh-invoice-ledger · Invoice-side duplicate, arithmetic and party checks when bank lines carry invoice refer

…(truncated)