Stax Digital Garden

QTM-1001 - Plain-Text Accounting Double-Entry Invariants in CommonMark Envelopes

2 min read

Living Document Notice
Published 2026-09-17. The evolving architecture, revisions, and connected notes for this dispatch live in the Stax Digital Garden.

Plain-Text Accounting Double-Entry Invariants in CommonMark Envelopes

Plain-Text Accounting Double-Entry Invariants in CommonMark Envelopes: Dual-trace Phosphor P1 high-persistence green and P4 paper white vector CRT macro showing plain-text double-entry balance scales, zero-sum posting vectors, and transactional envelope boundaries

Proprietary financial tracking suites trap ledger histories inside proprietary databases, opaque cloud sync silos, and binary backups. The Bosun Quartermaster subsystem establishes sovereign personal accounting using plain-text double-entry bookkeeping embedded within standard CommonMark markdown envelopes.

The Zero-Sum Invariant

Every transaction in double-entry bookkeeping must balance to zero. Credits must equal debits across accounts:

[ \sum ext{Postings} = 0 ]

Quartermaster parses fenced accounting blocks within daily notes or standalone ledger files:

```ledger:transaction
2026-09-17 * "Hosting Provider - Cloudflare" "Edge Proxy Ingress"
  Expenses:Infrastructure:Cloudflare        $20.00 USD
  Liabilities:CreditCard:Amex              -$20.00 USD

The parser validates the zero-sum balance before committing transactions to the internal financial graph. If a transaction fails to balance, the parser rejects the entry with an explicit delta error.

## CommonMark Envelopes for Financial Audit Trails

By embedding accounting transactions inside Markdown files, receipts, bank statements, and contextual notes live alongside the structured posting:

```markdown
### Edge Proxy Invoice Ingestion
The quarterly billing cycle reflects increased traffic from garden syndication.
Invoice PDF attached: `assets/2026-09-17_cloudflare_inv.pdf` (SHA256: 3c8e4...).

```ledger:transaction
2026-09-17 * "Cloudflare Inc." "Enterprise Zone Allocation"
  Expenses:Infrastructure:Edge        $120.00 USD
  Assets:Checking:FirstTech          -$120.00 USD


This ensures that five years later, financial ledger lines are accompanied by the operational context that created them.

---
* **Directus Target**: quartermaster
* **Garden Source Reference**: MOC - Personal Finance, Ledgers & Tax Manifests, MOC - Bosun PKM Tools
* **Garden Source Reference**: [QTM-1001 - Plain-Text Accounting Double-Entry Invariants in CommonMark Envelopes](QTM-1001 - Plain-Text Accounting Double-Entry Invariants in CommonMark Envelopes)

Graph View