fix(cash flow): a payment to a government is other operating, by its payee
The P3 cutover review's open point 2: a state's LLC filing fee, booked to an organization-costs account (tax category organization_startup), read as "Cash paid to suppliers and employees". B-14 rule 5 sent a payment to class (g) only when every operating line's account was taxes_licenses, so the account, not the payee, decided. ASC 230-10-45-17, read in EY's guide that reproduces it (Statement of cash flows, July 2026, p. 43; the PDF re-fetched and its SHA-256 recorded in docs/spec/sources/fasb-asc.md), lists apart "(b) Cash payments to other suppliers and employees for other goods or services" and "(c) Cash payments to governments for taxes, duties, fines, and other fees or penalties". 45-25's classes name only income taxes (f) among the latter, so the rest are (g), other operating cash payments. A formation filing fee is rightly an organization cost (its account and tax line), and still a payment to a government: the payee is what 45-17(c) is about. So rule 5 now sends a payment's government part to (g): of an operating payment the structure classes (d), what went to a party with the government_agency or tax_agency role (the chain root's parties, so a reversal keeps its original's class) is (g), on any account; and, as before, a payment whose every operating line is on a taxes_licenses account is (g). Every party a government: the whole payment. A government and a supplier named together: the payment is split by their resolved shares (B-35), the government's part (g), the rest (d), since ASC 230-10-45-22 has "each separately identifiable source or each separately identifiable use" classed "on the basis of the nature of the underlying cash flows" (EY p. 44; quoted in fasb-asc.md; it names the three activities, read for 45-25's classes too as a CONVENTION). The government's part is the payment x its share / the whole, rounded half to even to the base currency's places, the rest exact, so the line still sums to the payment and a reversal mirrors it. Shares that don't resolve leave the whole payment (d). One naming no party is decided by its accounts. Receipts are untouched (a refund from a government stays (c)). No total changes, only which operating row a payment is in. Two limits, from the review of this change: a government selling goods or services (postage) is 45-17(b)'s supplier "for other goods or services", so the rule says, and the handbook tells the agent, to add such a payee as a vendor, never with the government_agency role (the books can't tell what a payment bought; the role says it). And payroll keeps its structure (CONVENTION): an entry with a line on the salary expense or a payroll payable control account, or on a pay tax category (salaries_wages, officer_compensation, employee_benefits, pension_profit_sharing), stays (d) whoever it names: withheld taxes remitted are the employees' pay, and the payables mix them with the employer's taxes, which a remittance can't tell apart. So a remittance to the IRS is (d) as it was before this change; the employer's payroll tax paid on its own expense account is a tax, (g). The first company's books have this case: their state filing fee moves from "Cash paid to suppliers and employees" to "Other operating cash payments" at every date once its entry names the state's agency with the government_agency role and its own entry is the one whose cash the statement lists (paid from the bank, or on a card that is a lender's credit, D-42, or by a member through the members' account while it is a financing account, B-14 rule 11, the way that fee was paid); charged to an operating-payable card, its cash leaves in the card payment, whose payee is the bank, and it stays with suppliers. STATUS says how to check both, and that the cutover goldens' cash-flow snapshots will differ on the two class lines only (totals the same), so the next cutover diff isn't read as a regression. Docs: rules.md B-14 rule 5 (the rule, its source quoted, the date and what it was before); fasb-asc.md (45-17(b) and (c) quoted exactly, with the guide's SHA-256); the handbook's entries section (name the agency as the party on a tax, fee, fine or penalty paid to a government; a shared payment named with both amounts; a government selling services added as a vendor; payroll remittances stay with pay; a fee on a card follows the card payment); fasb-asc.md also quotes 45-22 and 45-22A; bookspec example cash-flow.government-fees.toml (a filing fee and a lawyer on one organization-costs account, a license on taxes and licenses with no party, a penalty to a tax agency on the wrong account, paper from a supplier, an annual report paid through a registered agent, 37.00 the state's and 100.00 the agent's; every figure by hand) with a new `class.<a..g>` key in the cash_flow query (bookspec README; the runner checks every class the statement has is given); testing.md; STATUS. Tests: ledger-core tests/spec_cash_flow.rs `a_payment_to_a_government_is_other_operating` (the filing fee and a penalty to a tax agency (g); the same account paid to a lawyer, or with no payee, (d); its reversal next month keeps (g); a refund (c)), `a_government_payee_moves_a_fee_on_any_account` (a taxes_licenses license with no party (g); a payment shared half and half between a government and a printer split 50.00 (g) and 50.00 (d), the government alone all (g)), `a_shared_government_payment_splits_to_the_cent` (a third by percent of 100.01: 33.34 (g), 66.67 (d); amounts split as given; the reversal mirrors to the cent), `a_payroll_remittance_to_a_tax_agency_stays_pay` (withheld taxes remitted from a payable holding its payroll role, and pay on a salaries_wages account, stay (d) with the IRS named; the employer's tax on its own expense account is (g)), `a_government_selling_services_is_a_supplier` (postage to a vendor (d); given government_agency, (g): the limit the handbook guards); src cashflow.rs `tests` `a_government_part_rounds_half_to_even` and the proptest `a_government_part_sums_and_mirrors`; the bookspec example; from the P4 review, `a_reversal_takes_its_originals_payee` (a fee and its reversal next month land in one class, the chain's payee deciding: the books keep a chain's parties one, so reading the reversal's own parties is an equivalent mutant) and `a_shared_government_payment_a_member_paid_splits_both_ways` (a shared payment a member paid: each part with its own on_behalf; fails with the on-behalf part unsplit). docs/mcp-interface.md: books.cash_flow and the Roles paragraph say a government or tax agency payee makes a payment other operating, and a shared one two operating lines. Broken to confirm: without the payee check the five spec tests and the example fail; without the split for mixed payees the two shared-payment tests and the example (class.d -549.50) fail; without the payroll exclusion the payroll test fails; rounding toward zero fails both unit tests; without the tax-category route `operating_classes_follow_asc_230_10_45_25`, the second test and the example fail. The viewer's cash flow page, rendered on made-up books before and after: the fee moved from "Cash paid to suppliers and employees" to "Other operating cash payments", every total the same; and on made-up books with an annual report shared between the state and an agent: each part on its own class line, every total the same. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01T3gXMVt7XJPi6ens1or9Dj
This commit is contained in:
11 files changed
+1049
-63
No files matched your search
+40
-5
@@ -188,11 +188,46 @@ its invoices. The handbook's caveat is gone for books with the feature.
|
||||
`projects` but not it, so until the owner's next format upgrade
|
||||
(`wanderbooks books upgrade`, D-39) their invoices and bills still take
|
||||
none (the handbook says so).
|
||||
- Raised by the cutover review (private change log, "Open points"): a
|
||||
state filing fee is classed as cash paid to suppliers where ASC
|
||||
230-10-45-17(c) suggests other operating payments; ties in the per-entry
|
||||
member split all go to the first member (the owner, 2026-10-22: nothing
|
||||
is posted until the year-end close, three weeks off, so it waits).
|
||||
- Raised by the cutover review (private change log, "Open points"):
|
||||
ties in the per-entry member split of the tax-basis K-1 all go to the
|
||||
first member (the owner, 2026-10-22: nothing is posted until the
|
||||
year-end close, three weeks off, so it waits).
|
||||
Its second point is done (2026-10-22, B-14 rule 5): a payment to a
|
||||
government (ASC 230-10-45-17(c), "Cash payments to governments for
|
||||
taxes, duties, fines, and other fees or penalties") is other operating
|
||||
cash payments, (g), never cash paid to suppliers, decided by its payee
|
||||
(a party with the government or tax agency role) on any account, as
|
||||
well as by a `taxes_licenses` account as before; a payment shared with
|
||||
a supplier is split by the parties' shares (45-22); payroll
|
||||
remittances from the payroll payables stay (d) as before; a government
|
||||
selling goods or services is a supplier (add it as a vendor). The
|
||||
first company's state filing fee, booked to its organization-costs
|
||||
account, moves from "Cash paid to suppliers and employees" to "Other
|
||||
operating cash payments" at every date (no total changes), provided
|
||||
(1) its entry names the state's agency with the `government_agency`
|
||||
role (check with `books.party`, give the role with
|
||||
`books.set_party_roles` if not), and (2) the fee's own entry is the
|
||||
one whose cash the statement lists: paid from the bank; charged to a
|
||||
card that is a lender's credit (the `financing_accounts` setting, D-42,
|
||||
borrowed and spent); or paid by a member personally through the
|
||||
members' account (Due to Shareholders) while that account is in
|
||||
`financing_accounts` (B-14 rule 11: borrowed from the member and spent
|
||||
on the fee's date, the operating part classed (g) with its
|
||||
`on_behalf`, and split the same way when shared:
|
||||
`a_shared_government_payment_a_member_paid_splits_both_ways`). The
|
||||
first company's fee was paid the last way (the books home's goldens
|
||||
change log, entry #1), so check its members' account is a financing
|
||||
account. Charged to a card, or paid through a members' account, that
|
||||
is an operating payable, its cash leaves in the later payment (to the
|
||||
bank, or the member's reimbursement), whose payee is not the state,
|
||||
and it stays with suppliers: check how it was paid (`books.get_entry`).
|
||||
Expected golden change: once this ships, the cash-flow snapshots in the
|
||||
books home's `goldens/` (each cutover's) differ from a fresh
|
||||
run on two operating lines, "Cash paid to suppliers and employees"
|
||||
smaller and "Other operating cash payments" larger by the fee, every
|
||||
section total, net change and cash balance the same. That is this
|
||||
rule, not a regression: diff the class lines against it at the next
|
||||
cutover and refresh the snapshot then.
|
||||
Its first point is done (2026-10-22, B-34 rule 8): the IIF writes each
|
||||
line's project in CLASS, the projects declared first in a `!CLASS`
|
||||
list, their names held to QuickBooks' 31 characters, no two alike, and
|
||||
|
||||
Reference in new issue
Block a user