ledger-ingest · git:20261115.c017ea4 · 2026-11-15 · sha256 8fbb75e669c0c0ad

ledger-ingest git:20261115.c017ea4A

Immutable. This exact content never changes and is served at /api/v1/blob/8fbb75e669c0c0ad.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_v3d4ozyg7yj7fmmr/8fbb75e669c0c0adf9f1de6f86ba5a9be888d48851f055472dc8a890a0b16ab3.json

Then /plugin install ledger-ingest@markdownregistry-v3d4ozyg7yj7fmmr in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
name: ledger-ingest
description: >-
  Plain-text accounting (Beancount / hledger) ingestion and reconciliation workflow.
  Parses bank CSV/OFX statements from local/inbox/ into double-entry postings in
  local/private/ledger/ and verifies zero-balance integrity.
---

# Plain-Text Accounting & Ledger Ingestion (`/ledger-ingest`)

Maintain a verifiable double-entry financial ledger inside `local/private/ledger/`.

## Steps

0. **Extension Dispatch & Overlay Check:** Run `hq dispatch resolve --skill=ledger-ingest --json`; if `overridden == true`, activate the resolved companion skill (`skill_path`) and stop following this file; if `has_overlay == true` with non-empty `overlay_rules`, apply those active personal rules for this run.
1. **Locate Statement & Ledger:**
   - Read the statement file from `local/inbox/` and inspect existing account definitions in `local/private/ledger/main.bean` (create starter chart of accounts if not yet initialized).
2. **Generate Double-Entry Postings:**
   - Convert each row deterministically into a dated Beancount transaction with explicit narration and category account.
   - Flag any ambiguous or high-value anomalous transactions for user review.
3. **Deterministic Validation:**
   - If `bean-check` or `hledger check` is installed, run it against `local/private/ledger/main.bean` to verify zero balance errors before finalizing.