| name | journal-entries |
| description | Post classified lines to balancing journals (balancing double-entry journals), then roll_tb. Use when journals, postings, double entry, JE list, or "post the books".
|
/journal-entries
Purpose
Convert classified activity into double-entry journals. Main job: post.
Engine posts; agent judges openings/exceptions.
Load shared/kernel-contract.md and shared/guardrails.md.
Step 1 — Post (required)
python3 scripts/post_journals.py \
--client-dir <client> \
--bank-code 1000 \
--opening-from-bank
python3 scripts/post_journals.py \
--transactions workpapers/transactions.json \
--output workpapers/journals.json \
--openings workpapers/journals_opening.json \
--bank-code 1000
npx @cynco/accounting-skills post <client> --opening-from-bank
| Input | Rule |
|---|
Classified transactions.json | Every line has account_code (or fail) |
| Inflow | DR bank · CR code |
| Outflow | DR code · CR bank |
| Openings | --openings file or --opening-from-bank (equity offset) |
Prefer the script over line-by-line chat postings (scripts).
Done when: journals.json written and every JE balances (script exit 0).
Step 2 — Roll preliminary TB (required)
python3 scripts/roll_tb.py --client-dir <client> --preliminary
npx @cynco/accounting-skills tb <client> --preliminary
TB totals only via roll_tb — never typed by the agent.
Done when: tb_preliminary.json exists and difference == 0 (or must stop recorded).
Manual / non-bank journals
Client-supplied or payroll/sales books: append balancing JEs to journals.json (same schema), then re-run roll_tb. Each JE must balance or the roll fails.
Gates
- Every JE: Σ DR = Σ CR
- No blank accounts
- Prelim TB difference = 0
Output
workpapers/journals.json + workpapers/tb_preliminary.json.
Next: bank recon → YE → roll_tb --adjusted.
