journal-entries

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

# or with explicit openings pack
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.