Optional: Check Your Work Packs (Ch01–Ch04)
===========================================

This workbook is meant to be a *learning* experience, not a “gotcha” test.
If you want to confirm you’re on the right track (or you’re stuck), use the downloads below to compare your work
against a known-good reference.

**What these packs are for**

- **Option A — “Check my spreadsheet work.”** Download the completed XLSX for your chapter and compare the numbers
  you calculated (then export your CSVs again).
- **Option B — “Check my LedgerLoom run.”** Run ``ledgerloom build`` and compare your generated artifacts to the
  reference outputs ZIP.

Canonical dataset contract
--------------------------

Each Workbook chapter has a canonical dataset under::

   examples/workbook/<chapter_slug>/

Treat that folder as the “answer key”. The reference outputs ZIPs are generated by running::

   ledgerloom build --run-id r1

for the canonical project and then zipping:

- the exported input CSVs (what students should export)
- ``outputs/r1/artifacts`` (what LedgerLoom should produce)
- ``outputs/r1/trust`` (run metadata + manifest)

How to compare (recommended)
----------------------------

1. Build your run:

   .. code-block:: bash

      ledgerloom check --project path/to/your_project
      ledgerloom build --project path/to/your_project --run-id myrun

2. Compare **inputs** first:

   - ``inputs/<period>/transactions.csv``
   - ``inputs/<period>/adjustments.csv`` (blank in Ch01–Ch02)

3. Compare **artifacts** second:

   - your ``outputs/myrun/artifacts/*.csv``
   - the reference ZIP’s ``artifacts/*.csv``

If your results differ, it’s almost always one of these:
a swapped debit/credit, a wrong account root, a missing line inside an ``entry_id``,
or an adjustment that belongs to a different period.

See :doc:`workbook_troubleshooting` for quick fixes.

Workbook Ch01 — Startup (solution pack)
=======================================

Canonical dataset::

   examples/workbook/ch01_startup

Downloads
---------

- :download:`Completed Ch01 spreadsheet (XLSX) <../_static/ledgerloom_workbook_completed_ch01_startup.xlsx>`
- :download:`Reference outputs pack (ZIP) <../_static/ledgerloom_workbook_reference_outputs_ch01_startup.zip>`

What the reference outputs include
----------------------------------

- ``entries.csv`` (the canonical journal lines)
- ``trial_balance_unadjusted.csv``

Workbook Ch02 — Journal → Trial Balance (solution pack)
=======================================================

Canonical dataset::

   examples/workbook/ch02_journal_to_trial_balance

Downloads
---------

- :download:`Completed Ch02 spreadsheet (XLSX) <../_static/ledgerloom_workbook_completed_ch02_journal_to_trial_balance.xlsx>`
- :download:`Reference outputs pack (ZIP) <../_static/ledgerloom_workbook_reference_outputs_ch02_journal_to_trial_balance.zip>`

What the reference outputs include
----------------------------------

- ``entries.csv``
- ``trial_balance_unadjusted.csv``

Workbook Ch03 — Adjusting entries (solution pack)
=================================================

Canonical dataset::

   examples/workbook/ch03_adjusting_entries

Downloads
---------

- :download:`Completed Ch03 spreadsheet (XLSX) <../_static/ledgerloom_workbook_completed_ch03_adjusting_entries.xlsx>`
- :download:`Reference outputs pack (ZIP) <../_static/ledgerloom_workbook_reference_outputs_ch03_adjusting_entries.zip>`

What the reference outputs include
----------------------------------

- ``entries.csv``
- ``trial_balance_unadjusted.csv``
- ``trial_balance_adjusted.csv``

Workbook Ch04 — Closing + post-close TB (solution pack)
=======================================================

Canonical dataset::

   examples/workbook/ch04_closing_and_post_close

Downloads
---------

- :download:`Completed Ch04 spreadsheet (XLSX) <../_static/ledgerloom_workbook_completed_ch04_closing_and_post_close.xlsx>`
- :download:`Reference outputs pack (ZIP) <../_static/ledgerloom_workbook_reference_outputs_ch04_closing_and_post_close.zip>`

What the reference outputs include
----------------------------------

- ``entries.csv``
- ``trial_balance_adjusted.csv``
- ``closing_entries.csv``
- ``trial_balance_post_close.csv``

**Post-close invariant:** the post-close trial balance must contain **only balance-sheet accounts**
(Assets / Liabilities / Equity). Revenue and Expense accounts should be zeroed out.