Description
WonderPhi Ledger v1.0.0 — Batch Recipe Library for Banking, Finance & Accounting (SKU 2103)
Inventor: Christopher Gabriel Brown
Status: Patent pending — see the inventor’s patent portfolio for the full schedule of filings. All rights to seek additional patent protection are expressly reserved.
Version: 1.0.0 (perpetual release — no subscription, no renewal, no telemetry, no forced updates)
SKU: 2103
Licence variants: Retail Single-User (personal / single-operator) & Industrial Commercial (organisation-wide, unlimited machines / VMs / containers / cloud instances)
Overview
WonderPhi Ledger is a companion library to WonderPhi Compute . It contains 25 batch recipes that cover CSV reconciliation, PDF form generation, tax-form rendering, OCR extraction, ACH/NACHA validation, OFAC sanctions screening, FX conversion, categorisation, regulatory archival, and financial-schedule computation.
The library writes a plain-text WonderPhi Compute plan ( .plan.wpc.txt ); WonderPhi Compute runs that plan — dispatching every task across every available CPU core. Nothing in this library connects to a bank, opens a socket, or phones home. It reads a folder and writes a .txt . That is all.
Zero external Python dependencies. The generator uses the Python standard library only ( argparse , csv , json , hashlib , fnmatch , sys , pathlib , datetime , re ). Recipes drive well-known external tools — wkhtmltopdf , tesseract , LibreOffice soffice , certutil , and 7z — but never modify wpc.exe . The 10 Commandments stay intact.
Recipe Categories & Full Recipe Table
25 recipes across 11 categories. Every recipe uses the files input model — scan a folder for matching extensions.
Recipe Category Needs on PATH What It Does
CSV Normalisation & Cleanup (6 recipes)
csv-dedupe csv Python (stdlib) Remove duplicate rows keyed on (Date, Amount, Description)
csv-sort-date csv Python (stdlib) Sort each CSV ascending by the Date column
csv-total csv Python (stdlib) Sum the Amount column of each CSV — fast trial totals
csv-row-hash csv Python (stdlib) Content-addressable SHA-256 hash over each CSV’s data rows
csv-to-xlsx csv LibreOffice ( soffice ) Convert each CSV to XLSX via LibreOffice headless mode
csv-to-json csv Python (stdlib) Convert each CSV to a JSON array of per-row objects
Compliance / OFAC Sanctions Screening (1 recipe)
ofac-scan-csv compliance Python (stdlib) + SDN list via --tag Match every row in each CSV against a local SDN name list; emit hits
PDF Generation (6 recipes)
pdf-invoice-from-json pdf wkhtmltopdf + Python Render one invoice PDF per JSON record (invoice_id, bill_to, amount, due)
pdf-statement pdf wkhtmltopdf Render a monthly account-statement PDF per JSON record
pdf-receipt pdf wkhtmltopdf Render a purchase-receipt PDF per JSON record
pdf-payment-reminder pdf wkhtmltopdf Render a payment-reminder letter PDF per overdue-account JSON
pdf-collection-letter pdf wkhtmltopdf Render a formal collection-letter PDF per delinquent-account JSON
pdf-wire-instructions pdf wkhtmltopdf Render bank wire-transfer instructions PDF per beneficiary JSON
Tax Forms (2 recipes)
pdf-1099-nec tax wkhtmltopdf + Python Render a 1099-NEC PDF per contractor JSON — set --tag=year (fields: name, TIN, Box 1 Nonemployee Compensation)
pdf-w2 tax wkhtmltopdf + Python Render a W-2 PDF per employee JSON — set --tag=year (fields: name, SSN, wages, federal withholding)
OCR — Optical Character Recognition (2 recipes)
ocr-receipt-each ocr Tesseract OCR each receipt image to text (English language model)
ocr-invoice-each ocr Tesseract OCR each invoice/statement image to text with layout preservation (PSM 6)
ACH / NACHA Payment Files (2 recipes)
ach-nacha-validate ach Python (stdlib) Validate each NACHA/ACH file — 94-character record length, record-type sequence, block count
ach-nacha-summary ach Python (stdlib) Emit per-file summary: batches, entries, total debit, total credit
Reconciliation (1 recipe)
csv-reconcile-2way reconcile Python (stdlib) Find rows in each CSV not matched (by Amount) in a reference file specified via --tag
Currency / Foreign-Exchange Conversion (1 recipe)
csv-fx-convert fx Python (stdlib) + rates.csv via --tag Apply FX rate table (CSV of currency, rate) to the Amount column; produce AmountUSD
Rules-Based Categorisation (1 recipe)
csv-categorize-rules rules Python (stdlib) + rules.json via --tag Apply regex categorisation rules (JSON array of {match, category}) to the Description column
Tamper-Evident Regulatory Archival (1 recipe)
regulatory-hash archival certutil (built-in on Windows) SHA-256 hash each file with an audit-trail sidecar; consolidate into a timestamped AUDIT-TRAIL-{tag}.txt
Financial Schedules (2 recipes)
depreciation-schedule schedule Python (stdlib) Straight-line depreciation schedule per asset JSON (fields: cost, life_years) — outputs Year, BeginningBook, Depreciation, EndingBook
amortization-schedule schedule Python (stdlib) Loan amortisation schedule per loan JSON (fields: principal, apr, months) — outputs Month, Payment, Interest, Principal, Balance
Command-Line Interface
The generator is invoked as:
python wpl-recipe.py [options]
Flag Meaning
--list List all 25 recipes with descriptions and exit
--out FILE Where to write the .plan.wpc.txt output file
--outdir DIR Where recipe output files go (default: wpl-out )
--tag VALUE Value substituted for {tag} in commands — tax year, reference-file path, rates.csv path, SDN list path, period label, etc.
--stdout Print the plan to standard output instead of writing a file
--check Report how many inputs matched; write nothing
Supported File Extensions by Recipe Type
Input Type Glob Patterns Used By
CSV *.csv csv-dedupe, csv-sort-date, csv-total, csv-row-hash, csv-to-xlsx, csv-to-json, ofac-scan-csv, csv-reconcile-2way, csv-fx-convert, csv-categorize-rules
JSON *.json pdf-invoice-from-json, pdf-1099-nec, pdf-w2, pdf-statement, pdf-receipt, pdf-payment-reminder, pdf-collection-letter, pdf-wire-instructions, depreciation-schedule, amortization-schedule
Image / Receipt *.jpg , *.jpeg , *.png , *.pdf , *.tif , *.tiff , *.webp ocr-receipt-each, ocr-invoice-each
NACHA / ACH *.ach , *.nacha , *.txt ach-nacha-validate, ach-nacha-summary
All files * regulatory-hash
External Tools Driven by Recipes
Tool Purpose Recipes
Python 3.8+ (stdlib only) CSV parsing, JSON parsing, SHA-256 hashing, deduplication, sorting, reconciliation, FX conversion, categorisation, NACHA validation, depreciation & amortisation calculations csv-dedupe, csv-sort-date, csv-total, csv-row-hash, csv-to-json, ofac-scan-csv, csv-reconcile-2way, csv-fx-convert, csv-categorize-rules, ach-nacha-validate, ach-nacha-summary, depreciation-schedule, amortization-schedule, pdf-invoice-from-json, pdf-1099-nec, pdf-w2
wkhtmltopdf HTML-to-PDF rendering for invoices, statements, receipts, letters, forms, and wire instructions pdf-invoice-from-json, pdf-1099-nec, pdf-w2, pdf-statement, pdf-receipt, pdf-payment-reminder, pdf-collection-letter, pdf-wire-instructions
Tesseract OCR Optical character recognition (English) with standard and PSM 6 layout modes ocr-receipt-each, ocr-invoice-each
LibreOffice ( soffice ) Headless CSV-to-XLSX conversion csv-to-xlsx
certutil (Windows built-in) SHA-256 file hashing for tamper-evident regulatory archival regulatory-hash
7-Zip ( 7z ) Archive compression (referenced in documentation) Archival workflows
Plan-File Format
Every recipe emits a plan file beginning with the header # WPC v1 , followed by metadata comments ( recipe , desc , model , tag , tasks ) and one command line per input file. Plans that include a post-processing step (e.g. regulatory-hash ) insert a # --- barrier --- marker before the consolidation command. The plan is a pure text file — human-readable, auditable, and versionable — and is executed by wpc.exe .
Architectural Principles
- Library writes the plan; WonderPhi Compute runs the plan. Separation of generation and execution.
- No network. No telemetry. Nothing phones home. Nothing connects to a bank or external API.
- Never modifies wpc.exe . The constitutional 10 Commandments of WonderPhi Compute remain intact.
- Zero external Python dependencies. Standard library only — csv , json , hashlib , argparse , fnmatch , sys , pathlib , datetime , re .
- Self-contained one-liner templates. Each recipe’s command template is a standalone python -c one-liner or direct tool invocation, suitable for cmd.exe dispatch.
- Constitutional warranty. Every copy of WonderPhi Compute is governed by the 10 Commandments recorded in commandments.py . Any binary that fails the constitutional checksum at startup refuses to run.
Example Workflows
# Reconcile a bank export against the internal ledger python wpl-recipe.py csv-reconcile-2way .\bank_exports --tag .\internal_ledger.csv
# Apply FX rates to a folder of foreign-currency transactions python wpl-recipe.py csv-fx-convert .\eu_txns --tag rates.csv
# Generate 1099-NEC PDFs for 500 contractors python wpl-recipe.py pdf-1099-nec .\contractors --tag 2026
# OFAC-screen a customer CSV against a local SDN name list python wpl-recipe.py ofac-scan-csv .\customers --tag ofac_sdn.txt
# Compute straight-line depreciation schedules for a folder of asset JSONs python wpl-recipe.py depreciation-schedule .\assets
# Batch OCR paper receipts to text python wpl-recipe.py ocr-receipt-each .\receipts
# Validate a folder of NACHA files (94-char record length, sequence) python wpl-recipe.py ach-nacha-validate .\ach_pending
# Regulatory tamper-evident archive of a period’s records python wpl-recipe.py regulatory-hash .\q3_2026_records --tag 2026Q3
Depreciation & Amortisation Formulas
Schedule Method Formula Input JSON Fields Output CSV Columns
Depreciation Straight-line Annual = Cost ÷ Life_Years; EndingBook y = Cost − (y × Annual) cost , life_years (default 5) Year, BeginningBook, Depreciation, EndingBook
Amortisation Standard loan amortisation PMT = P × r × (1+r) n ÷ ((1+r) n − 1), where r = APR ÷ 12 ÷ 100 principal , apr , months Month, Payment, Interest, Principal, Balance
System Requirements
Requirement Detail
Python 3.8 or later (standard library only — no pip install needed)
WonderPhi Compute Required to execute the generated plan files ( wpc.exe )
wkhtmltopdf Required for all PDF-generation and tax-form recipes (8 recipes)
Tesseract OCR Required for the 2 OCR recipes (English language model)
LibreOffice ( soffice ) Required for csv-to-xlsx (headless mode)
certutil Built-in on Windows; required for regulatory-hash
Operating system Windows (command templates target cmd.exe )
Licensing
Licence Variant Scope Key Terms
Retail Single-User One individual — any and all machines personally owned or administered Perpetual, non-exclusive, non-transferable. No seat count, no activation, no telemetry. Source code may be read, studied, and modified for personal use. No redistribution; no SaaS / hosted use.
Industrial (Commercial) One organisation (legal entity on purchase receipt + wholly-owned subsidiaries) — unlimited machines, VMs, containers, cloud instances Perpetual, non-exclusive, non-transferable. Employees, contractors, and consultants may operate for the organisation’s benefit. Production and revenue-generating workloads permitted. No redistribution; no resale or white-label embedding (OEM licence available separately).
Both variants: governed by the laws of the State of Georgia, USA. Disputes resolved in state or federal courts in Gwinnett County, Georgia.
What Is in the Package
File Size Lines Description
wpl-recipe.py 18,540 bytes 375 The recipe generator — 25 recipes, CLI, plan emitter. Python 3.8+, stdlib only. Contains all command templates, file-scanning logic, and plan-file writer.
README.md 4,082 bytes 127 Full documentation: overview, recipe list, usage examples, CLI options, directory layout, system requirements.
INDEX.md 2,776 bytes 40 Recipe index table: all 25 recipes with category, input model, PATH dependencies, and descriptions.
LICENSE 4,919 bytes 127 WonderPhi Software Licence v1.0.0 — Retail Single-User. 9 sections covering grant, restrictions, IP, warranty, liability, termination, governing law.
LICENSE-INDUSTRIAL.txt 6,163 bytes 147 WonderPhi Software Licence v1.0.0 — Industrial (Commercial). Organisation-wide grant with OEM restriction.
release/wonderphi-ledger-v1.0.0.zip 9,719 bytes — Release archive.
Total package: 7 files · 48,112 bytes · 25 recipes · 11 categories · 0 external Python dependencies
How this is delivered
This package ships on a single Blu-ray disc, posted to the delivery address on your order. The archive on the disc is AES-256 encrypted; the passphrase is sent separately, by email, once the disc is despatched — so the disc alone is of no use to anyone who intercepts it.
Discs are despatched by tracked, signed-for post. Allow 5 business days for mastering and verification before despatch.
© 2026 Christopher Gabriel Brown. All rights reserved.
Footnotes
- Product number 8522.
- Family: wonderphi.
- Purchase: When you buy, you buy the use of that blueprint only.