{ "checker": { "claims": [ { "claim": "Render a Sankey PNG from a month of budget rows", "command": " render budget.csv -c PLN -o claim-render.png", "evidence": "\u2713 claim-render.png\nincome 11\u202f250\u202fz\u0142 spent 7\u202f634\u202fz\u0142 left over 3\u202f616\u202fz\u0142 24 rows\nfindfont: Failed to find font weight medium for DejaVu Sans, now using 400.\nfindfont: Failed to find font weight semibold for DejaVu Sans, now using 700.\n", "expected": "PNG written and reported", "input": "budget.csv with -c PLN -o claim-render.png", "kind": "claim", "outcome": "Real input produced the expected result: \u2713 claim-render.png", "returncode": 0, "source": "Turn a month of budget rows into a Sankey diagram you can share as a PNG.", "source_checked": true, "source_file": "README.md", "verdict": "yes" }, { "claim": "A missing rate fails and the error says what to add", "command": " render trip.csv -c PLN -o norate-claim.png", "evidence": "Give a rate for each one, for example: --rate EUR=4.30 (one EUR is worth 4.30 PLN)\n", "expected": "exit 2 with a Give a rate hint", "input": "trip.csv with EUR rows and no --rate", "kind": "claim", "outcome": "Real input produced the expected result: Give a rate for each one", "returncode": 2, "source": "Forget a rate and the error tells you what to add:", "source_checked": true, "source_file": "README.md", "verdict": "yes" }, { "claim": "vme formats prints the list of input formats", "command": " formats", "evidence": "Input formats\n camt .camt, .xml ISO 20022 camt.052/053/054 bank statements (SEPA XML)\n csv .csv, .tsv, .txt Comma/semicolon/tab separated values with a header row\n excel .xlsx, .xlsm Excel workbook (.xlsx), first sheet unless --sheet is given (needs openpyxl)\n json .json JSON array of rows, or {\"expenses\": [...]}\n jsonl .jsonl, .ndjson JSON Lines / newline-delimited JSON\n ofx .ofx, .qfx OFX / QFX bank & card statements (Quicken, Money, most US banks)\n qif .qif QIF (Quicken Interchange Format) exports\n\nOutput: .p", "expected": "Input formats heading", "input": "formats", "kind": "claim", "outcome": "Real input produced the expected result: Input formats", "returncode": 0, "source": "`vme formats` prints the same list.", "source_checked": true, "source_file": "README.md", "verdict": "yes" }, { "claim": "vme currencies lists the known currencies", "command": " currencies", "evidence": "AED \u062f.\u0625 UAE dirham 1,234.50\u202f\u062f.\u0625\n ARS AR$ Argentine peso AR$1\u202f234,50\n AUD A$ Australian dollar A$1,234.50\n BGN \u043b\u0432 Bulgarian lev 1\u202f234,50\u202f\u043b\u0432\n BRL R$ Brazilian real R$1\u202f234,50\n BTC \u20bf Bitcoin \u20bf1\u202f234.50000000\n CAD CA$ Canadian dollar CA$1,234.50\n CHF CHF Swiss franc 1'234.50\u202fCHF\n CLP CLP$ Chilean peso CLP$1\u202f235\n CNY \u00a5 Chinese yuan \u00a51,234.50\n COP COL$ Colombian peso COL$1\u202f235\n CZK K\u010d Czech koruna 1\u202f234,50\u202fK\u010d\n DKK kr Dani", "expected": "list including AED", "input": "currencies", "kind": "claim", "outcome": "Real input produced the expected result: AED", "returncode": 0, "source": "`vme currencies` lists them.", "source_checked": true, "source_file": "README.md", "verdict": "yes" } ], "cycle_checks": [ { "claim": "Scheduled or looping main behavior", "command": "", "evidence": "Entry points inspected (src/vme/cli.py and README). No cron, scheduler, loop, --once/--now, or webhook code found; vme is a one-shot CLI that runs once per invocation, so no product cycle to replay.", "expected": "identify the product trigger", "input": "source inspection", "kind": "cycle", "outcome": "Entry points inspected (src/vme/cli.py and README). No cron, scheduler, loop, --once/--now, or webhook code found; vme is a one-shot CLI that runs once per invocation, so no product cycle to replay.", "source": "repository entry points", "verdict": "yes" } ], "details": { "argv": [ "", "sample", "" ], "expected_file": "", "file_checked": true, "file_excerpt": "date,category,label,amount,currency,kind\n2026-08-01,Income,Salary,9800.00,PLN,income\n2026-08-05,Income,Freelance,1450.00,PLN,income\n2026-08-02,Housing,Rent,3200.00,PLN,expense\n2026-08-02,Housing,Electricity,210.40,PLN,expense\n2026-08-03,Housing,Internet,79.00,PLN,expense\n2026-08-04,Groceries,Biedronka,412.85,PLN,expense\n2026-08-11,Groceries,Biedronka,388.20,PLN,expense\n2026-08-18,Groceries,Local market,164.00,PLN,expense\n2026-08-25,Groceries,Lidl,297.55,PLN,expense\n2026-08-06,Transport,Monthly pass,110.00,PLN,expense\n2026-08-14,Transport,Fuel,320.00,PLN,expense\n2026-08-22,Transport,Parking,48.00,PLN,expense\n2026-08-07,Eating out,Lunches,486.30,PLN,expense\n2026-08-16,Eating out,Coffee,142.60,PLN,expense\n2026-08-09,Health,Pharmacy,178.90,PLN,expense\n2026-08-20,Health,Dentist,450.00,PLN,expense\n2026-08-08,Subscriptions,Spotify,23.99,PLN,expense\n2026-08-08,Subscriptions,Netflix,43.00,PLN,expense\n2026-08-10,Subscriptions,Gym,159.00,PLN,expense\n2026-08-13,Leisure,Cinema,68.00,PLN,expense\n2026-08-24,Leisure,Books,127.40,PLN,expense\n2026-08-28,Leisure,Concert tickets,240.00,PLN,expense\n2026-08-15,Family,Kids' school trip,300.00,PLN,expense\n2026-08-27,Family,Gifts,185.00,PLN,expense\n", "kind": "cli", "needs_browser": false, "needs_credentials": false, "returncode": 0, "scope": "product operation", "stderr": "", "stdout": "\u2713 \n now try: vme render -c PLN -o august.png", "working": true }, "evidence_strength": "readme_checked", "example_checks": [ { "claim": "Write an example file to start from", "command": " sample ", "deferred": false, "evidence": "ing,48.00,PLN,expense\n2026-08-07,Eating out,Lunches,486.30,PLN,expense\n2026-08-16,Eating out,Coffee,142.60,PLN,expense\n2026-08-09,Health,Pharmacy,178.90,PLN,expense\n2026-08-20,Health,Dentist,450.00,PLN,expense\n2026-08-08,Subscriptions,Spotify,23.99,PLN,expense\n2026-08-08,Subscriptions,Netflix,43.00,PLN,expense\n2026-08-10,Subscriptions,Gym,159.00,PLN,expense\n2026-08-13,Leisure,Cinema,68.00,PLN,expense\n2026-08-24,Leisure,Books,127.40,PLN,expense\n2026-08-28,Leisure,Concert tickets,240.00,PLN,expense\n2026-08-15,Family,Kids' school trip,300.00,PLN,expense\n2026-08-27,Family,Gifts,185.00,PLN,expense\n", "expected": "CSV header written", "input": "", "kind": "example", "outcome": "command completed successfully", "returncode": 0, "source": "README.md ## Try it in 30 seconds", "verdict": "yes" }, { "claim": "Multi-currency render with a rate", "command": " render trip.csv -c PLN --rate EUR=4.30 -o example-trip.png", "deferred": false, "evidence": "\u2713 example-trip.png\nincome 9\u202f800\u202fz\u0142 spent 3\u202f415\u202fz\u0142 left over 6\u202f385\u202fz\u0142 3 rows\nfindfont: Failed to find font weight medium for DejaVu Sans, now using 400.\nfindfont: Failed to find font weight semibold for DejaVu Sans, now using 700.", "expected": "PNG written", "input": "trip.csv --rate EUR=4.30", "kind": "example", "outcome": "command completed successfully", "returncode": 0, "source": "README.md ## Multiple currencies", "verdict": "yes" }, { "claim": "Development test suite", "command": " -q", "deferred": false, "evidence": "........................................................................ [ 19%]\n........................................................................ [ 39%]\n........................................................................ [ 59%]\n........................................................................ [ 79%]\n........................................................................ [ 99%]\n. [100%]", "expected": "all tests pass", "input": "repository tests", "kind": "example", "outcome": "command completed successfully", "returncode": 0, "source": "README.md ## Development", "verdict": "yes" } ], "status": "PASS" }, "deviations": [ "Used a venv at instead of uv sync (uv not required for the pip path the README also documents).", "Ran the test suite by installing the checkout ( plus pytest) into the venv instead of uv run pytest; this replaced the PyPI vme-py with the same version 0.1.3 and was then reinstalled from PyPI for the checked probes.", "First 'vme check' and 'vme summary' runs without -c failed because the default report currency is USD while the rows are PLN; this is product behaviour (error message tells you to add a rate), not a setup failure. Re-ran with -c PLN, which passed.", "One of my own commands passed an invalid '--open=false' flag, which vme rejected; re-ran without it. Not a product issue.", "Font warnings (findfont: DejaVu Sans weights) on stderr are cosmetic matplotlib messages; PNG output was still produced." ], "fault_owner": null, "main_blocker": null, "operation": "Install vme-py and turn a month of budget rows into a Sankey PNG with the vme CLI (vme sample, vme render, vme summary, vme check, vme formats, vme currencies), plus the repo's pytest suite.", "operation_scope": "Linux guest (Ubuntu, Python 3.12.3, README requires 3.9+), venv at , core install only (no optional excel/html extras), no network rate lookups, no browser needed.", "outcome": "working", "plain_failure": null, "steps": [ "git init; git remote add origin https://github.com/oskar-j/visualize-my-expenses; git fetch --depth 1 origin 56046c530614262069a88cce3d06379713315df5; git reset --mixed FETCH_HEAD", "python3 -m venv && install vme-py (README: pip install vme-py)", "vme sample budget.csv (README: Try it in 30 seconds)", "vme render budget.csv -c PLN -o august.png (README quickstart; produced 1600x1536 PNG)", "vme summary budget.csv -c PLN; vme check budget.csv -c PLN; vme formats; vme currencies", "vme render trip.csv -c PLN --rate EUR=4.30 (README: Multiple currencies)", "vme render trip.csv -c PLN with no rate -> exit 2 with 'Give a rate for each one' hint (README: Forget a rate)", "pytest -q in the repo (README: Development) after pip install of the checkout with [all] extras" ], "stuck_step": null, "suggested_fix": null }