# wanderbooks

Canonical double-entry bookkeeping, rebuilt from scratch — the storytold way:
an engine verified against oracles, with automated parity tracking, on its
way to becoming a self-hosted bookkeeping app that never charges rent.

## Status

Phase 1: the semantics engine. `ledger-core` implements the accounting laws
in Rust — exact decimal money, five account types, balanced journal entries,
immutable posted log with reversing entries, trial balance, P&L, and balance
sheet — with 14 invariant tests and golden-file report snapshots.

See [`plan/STATUS.md`](plan/STATUS.md) for where things stand and
[`plan/roadmap.md`](plan/roadmap.md) for where they're going.

## Quickstart

```bash
cargo test
```

That's the whole test suite: validation rejections, immutability, the
accounting equation on a fixture company, a 300-entry randomized invariant
test, and the golden oracle test.

## Layout

```
crates/ledger-core/   # the engine: money, accounts, journal, ledger, reports
docs/                 # requirements, architecture, oracle design, parity, glossary
plan/                 # STATUS.md, roadmap.md
AGENTS.md             # operating manual for agents working here
```

## The idea, briefly

storytold/ArtCraft showed that agents can clone full applications with the
right machinery: screenshot-in-the-loop verification, render oracles, and
automated parity floors. `wanderbooks` adapts that pipeline to bookkeeping,
where the oracle is semantic instead of visual — GnuCash (open source, open
formats) is both the spec and the reference implementation we diff against,
and two engines fed the same books must produce byte-identical reports.
Details in [`docs/oracle.md`](docs/oracle.md).

## License

MIT OR Apache-2.0. See `LICENSE-MIT` and `LICENSE-APACHE`.