Money — history

The dated record of how Money got here, moved out of the spec on 2026-11-16 because a reader does not need it to use the spec today. Everything smaller is in git log -- atoms/money.md.

Decisions

  • 2026-11-13 — Drafted from the maintainer’s design session of the same morning, corrected from a first draft by Grok and again from GLM’s review of the corrected draft. Chose: a value the atom never stores, an amount in a currency’s minor unit with the currency (the maintainer, 2026-11-13: “Pre design saves us rounds”); signed amounts, the limit to zero or more left to the pattern that needs one (Non-goal 12); a rate as a numerator and a denominator, a number and never a money; four roundings named on every call and no default (Operation 14); every rounding and every split worked on the size with the sign kept, so a refund is the negation of the charge (the maintainer’s yes, 2026-11-13; Invariant 6.1, Invariant 6.2), and [Negate] to make one (GLM’s review: the headline property had no action); a split whose leftover minor units go left to right (the maintainer’s yes, 2026-11-13), narrowed by the drafter to the parts the rounding down took from (Operation 21, Term short part); every definition in whole numbers, a quotient and a remainder in place of an exact fraction (GLM’s review, citing GRACE-lang Closed vocabulary 32); a number cap on every whole number a call names or answers and a part cap on a split, each a default a deployment may override (GLM’s review: a split answer with no bound), with the floor under the number cap carried to the moneys the composing patterns hold (Capability requirement 3; GLM’s review: a lowered cap stranded a held money). Over: a stored record with a database and an auditor of versions (Grok’s draft); a default rounding; rounding toward the two infinities (a refund lands a minor unit off the charge); the leftover to the first parts whatever the exact share, as first agreed (a part due a whole number takes an extra minor unit: 2 split by shares of 2, 1 and 1 answers 2, 0 and 0, a whole minor unit off, in 4,852 of 94,380 small cases tried, both counts reproduced by GLM’s review); the largest remainder first (the same fairness, with a comparison the caller’s order cannot steer); a list of accepted currencies in the atom (Currency’s, Non-goal 2); an invariant that the same call answers the same answer and a check that nothing is stored (GLM’s review: corollaries that constrain nothing); Cart and Gift Card reopened to lean on the atom (the maintainer, 2026-11-13: not now). Because: the EOS test keeps one freestanding concept, the arithmetic of an amount in one currency, and names an owner for everything a shop or a bank layers on it (Non-goal 1 through 13); as simple as possible without losing fidelity keeps six actions and two settings; and Invariant 3.1 as the session stated it, no part a whole minor unit off its exact share, holds only under the narrowed rule, tried on 94,380 small splits and 60,000 wide ones, with 282,812 multiplies and 30,016 round trips beside them.