Stories A told story · ruled 2026-11-17 — round 2 of /finance (text/finance-page-brief.md § Round 2)
The Finance dashboard
This file holds three things: the order a person reads /u/<slug>/finance in,
what each number is and where it is read from, and what we cut because we
cannot fill it truthfully today. The Finance Director owns this file. Design
owns § Style, and engineering owns the split into components and lanes.
The rules behind every line are in text/finance.md and the finance-books
skill. Test money is never counted as money. A credit is never printed as a
dollar. A number we could not read says "Not available", never 0.
Two readers, two pages
The same URL serves two readers, and they need different first numbers.
- ONE's own page,
/u/one/finance. It is behind the books gate (lib/finance/gate.tsbooksGated). The reader is Tony or a finance seat, and the question is "is the business healthy?" - Every other group's page. It has no books. The reader is a group owner, and the question is "what do I hold, and what have I been paid?"
The order — every finance page
Tony's rulings, 2026-11-17. First: "put this at the top and work down the page to provide a beautiful, polished clear financial dashboard beautiful simplicity". Then, about the Accounts, Received, money line and Your path run: "this is really the most beautiful financial dashboard". That run comes first on every finance page, ONE's own included, and it is kept exactly as it looks. The books sit below it, never above, and take its style. "Everything in Finance" (the room tiles) is removed from this page. The other room pages keep their tiles.
| # | Section | What it shows | Read from | Fresh |
|---|---|---|---|---|
| 1 | Accounts: Credits · Wallets · Card payments | Credits: balance, used in the last 30 days, runway, bought, and the overdraft line. Credits are in credits, and "Bought" is dollars actually paid. Wallets: real money balances per chain, each with its own read, the agent wallets, Stake, and Open wallets. Staking runs on Sui testnet only, so on the real-money view the link says "Stake on testnet". Card payments: the live Stripe balance, or "Balance unavailable". | loadFinanceOverview, /api/payments/wallet, storefront:balance |
per read, client side |
| 2 | Money received and its money line | Settled money paid to this group over all time, the line month by month for 12 months, and a split into card and crypto. Credits received are their own figure, in credits. "On the way" is pending and never added. | loadFinanceOverview().nets.mainnet |
per read |
| 3 | Your path | Accept crypto, connect card payments, then first payment, $1,000, $10,000 and so on, read from mainnet money only. | loadFinanceOverview().milestones |
per read |
| 4 | The health sentence | ONE's own page only, behind the books gate. One line built from the numbers below, in the shape "cash in from customers over the window, what went out to model providers, how many drift rows", each figure read, never typed, with the 7 / 30 / 90 day pill. | healthSentence(loadHealth) |
per read |
| 5 | Money row: Cash in · Cost of goods · Margin · Cash on hand | ONE's own page only. Four cards, dollars only. Margin turns red below zero and says "margin below zero" in words. Cash on hand says which chains it read, and keeps its reconcile line with Wallets. | loadHealth numbers 1, 2, 3, 5 |
per row, per call, per read |
| 6 | Watch row: Unbilled · Drift · Paying customers · Credits owed | ONE's own page only. Unbilled shows dollars first, with the percent of model cost beside it. Drift shows rows and credits, with "warn" in words above zero. Paying is a count of groups. Credits owed says "not computable yet" and why. | loadHealth numbers 4, 7, 8, 6 |
per call, daily cron, per webhook |
| 7 | P&L by month, the sheet | ONE's own page only. Month · In · Cost · Margin, then a Total row. Download CSV in its header. Each cell's source and read time are in its title. | loadPnl through lib/finance/sheet.ts resolveCell |
per read |
| 8 | What the books cannot say yet | ONE's own page only. Three lines, marked "not in any total": grant 7 (a top-up, unconfirmed), granted credits (in credits, never dollars), and model cost off the gateway (not read). | loadPnl().open |
per read |
| 9 | The money map, A to J | The ten stations and their moves (§ The money map, below). The structure shows on every page. The moves follow the page's authorization. | the map's data file and the moves above | per read |
Rows 1 to 3 show on every group's page. Buy credits and Sell sit in the page header, and only when the viewer IS this group.
Money received on ONE's own page: one fact, two windows
On ONE's page, Money received (row 2) and Cash in (row 5) are the same
fact, read through the same books fence (SETTLED_ONLY, CASH_FROM_OUTSIDE,
LANDED_WITH_ONE), over two windows:
- Money received is all time, with its line by calendar month. Its label says "all time".
- Cash in is the window the pill chose (7, 30 or 90 days). Its label says that window.
They are not two copies, because the windows differ and each one says its own. They must agree: for every month both cover, the money line's month equals the P&L's Cash in for that month. A test pins that equality on the platform slug.
"On the way" on ONE's page reads the same fence too: pending, live, a cash rail, a payer outside the own set, landing with ONE. Otherwise an owner's own pending payment would show as money on the way from a customer. Every other group's pending stays as it is.
Your path on ONE's page needs no change. Its money steps read the fenced received figure, so "First payment" and the steps after it count only outside money. "Connect card payments" reads ONE's own Connect account and says what is true: ONE's live card rail is not armed.
Rules every section keeps
- A source and a time on every number. The books carry
sourceandasOfper figure; show the time once in each section header ("read 03:12 UTC") and the source in the number's title.loadFinanceOverviewgains oneasOffor the read wave. Chain and Stripe reads show their own time. - Not read is said, never 0. Ruling 1 on this page: every overview read
that fails is
nullwith a named not-read, and the screen says "Not available" in the number's place. A section whose reads all failed keeps its frame and says so. It never disappears, and it never breaks the page. - The books gate fails closed. If the check of who may read ONE's books errors, the page refuses. A gate failure never shows a single number.
- Credits are credits. No
$beside a credit total anywhere on the page. "Bought" is dollars because it is money actually paid (cents_paid). - One number per fact. ONE's "received" money reads the books fence
(
SETTLED_ONLY,CASH_FROM_OUTSIDE,LANDED_WITH_ONEfrombooks-fence.ts), the same as Cash in. - Test money is labelled on every figure. The Mainnet / Testnet switch moves only the Accounts and Received sections. ONE's books are always live money and never move with the switch. On Testnet each figure says "Test" (test payments, test top-ups) and wears the testnet card style.
Cut, because we cannot fill it truthfully today
| Cut | Why | Comes back when |
|---|---|---|
| "Worth about $X of AI work" on the Credits card | It prints credits × $0.001 as dollars. On a group that bought credits cheaply, it shows many times what was paid. | never; a credit is not a dollar |
| Platform fees in the P&L table | Card orders carry no live/test flag yet, so the figure is pending and counted: false. It stays in the CSV. |
orders.test_mode lands (task:01a1e38a5d979bae1b51a694) |
| "Everything in Finance", the room tiles | Tony, 2026-11-17: removed from this page. Its counts could not tell a real zero from a failed read, and one tile carried a dead name. Other room pages keep their tiles. | — |
| A budget you can edit | credits:cap is not built. The budget cell stays disabled and says why. |
credits:cap lands (task:01a1e3889e679ab07ae70ef4) |
| Runway in months, a forecast, cash across all five chains | No receiver reads them yet. Showing a number would mean inventing it. | text/finance.md § A strong finance system, features 7 and 16 |
| Monthly recurring revenue | No group holds a Stripe subscription, and the subscription grants record no money. An MRR card would be a zero dressed as a metric. | a live subscription |
What is open, and whose call it is
- Grant 7 (vespio's card top-up of 2026-06-29): was it received? This is Tony's call. Until he decides, it is shown, marked unconfirmed, and never added.
- Granted credits: are they owed (deferred revenue) or a promotion? This is Tony's call. The interim treatment is a promotion at $0. It is stated on the page, not applied to any total.
The money map, A to J — every claim, ruled
The centrepiece (text/finance-page-brief.md § the centrepiece). The map draws
the ten stations and the paths between them exactly as text/finance.md
§ The money map draws them. This section is what each station is allowed to
say. Only the Finance Director changes it.
Checked on 2026-11-17 against git: prod is e45681261 (origin/main,
344 commits behind dev), and dev is origin/dev. Production routes were probed
with curl. The ledger figures marked "seen" come from the production read of
2026-11-16 08:00 UTC in text/finance.md, and a read-only production read
on 2026-11-17 confirmed every status word below. No word changed. None of
those figures is typed onto the page. Any number the map shows is read when
the page renders.
Five status words, and nothing else
| Word | Means | Proven by |
|---|---|---|
| Live | on prod and seen in use, with its unit stated (dollars, USDC or credits) | a live ledger row or a chain read |
| On prod | shipped, but no live money seen through it yet | file or receiver in e45681261 |
| On dev | built, not shipped: never "live" | in origin/dev, not in e45681261 |
| Designed | written down, no code | a doc, no receiver |
| Not started | — | — |
A test label sits beside any of these when the only money is test money.
The stations
A · Keys and wallets: who holds it. One key, five chains.
- One key, with 24 words on paper that bring it back: On prod (
/key200,/w/restore200) - Wallets on Sui, EVM, Solana, BTC and ASI from that one key: On prod, and Sui balances are read live from the chain
- Send on Sui, ETH, Base and Arbitrum (
wallet:send,one wallet send): On prod. A send signs on the device and writes no ledger row, so the map cannot draw sends. - Ask to be paid (
wallet:invoice): On prod - Send on Solana or Bitcoin: Not started
- Moves to draw: this group's wallets, chain by chain, with each balance's read time (the Wallets card's reads).
B · Treasury and limits: who may move it.
- A vault on Sui mainnet, with each agent's ceiling enforced by the chain: Live. Read from Sui mainnet on 2026-11-17: the owner's vault holds USDC, and an agent has already spent through its ceiling, which the chain capped per payment and per period. So the limit is not a design: it has held real money. The package
0xe930…a957is ine45681261. - The owner is never refused on credits: Live
- Sweep earnings home (
wallet:sweep,wallet:sweep-set): On prod - The spend limit door: $50 alone, a fingerprint above it: On dev (244a76fd1; its migration ships before the worker)
- USDC sweep, fund-from-parent, earned overdraft: Designed
- Moves to draw: ONE's page only: cash on hand, the address plus its vaults (health number 5). Other groups: none.
C · Money in: how it arrives.
- Buy credits over x402: Live (every row carries a verified chain digest). The first dollar was agent
onebuying for itself, so it is not outside money. - Swap between chains (
swap:quote,swap:get): On prod - On-ramp,
/on: your own bank details, card or Apple Pay, and local QR (ramp:account,ramp:kyc,ramp:deposits,ramp:status): On dev./onanswers 404 on one.ie. It ships geo-closed, with no partner signed. - Testnet faucet (
/api/payments/faucet): On prod, test money only - Moves to draw: credits this group bought with real money (
cents_paid, in dollars), labelled "Credits you bought", never a bare "Money in". A group with unlimited credits (one,tony) reads "Unlimited credits, none bought" instead of $0.00. Then the/onpath as a labelled example, never as a $0.00 move. On vespio's map, grant 7 (its card top-up of 2026-06-29) keeps its books label: unconfirmed, never drawn as confirmed money in.
D · Get paid: selling.
- A shop takes USDC on Sui: Live (one live payment, payer not identified)
- Sell in ChatGPT, paid on your shop: On prod
- Payment links (
links:create): On prod - Sellers take cards through their own Stripe: On prod, test money only (no Connect account can charge yet)
- ONE's own checkout takes live cards: On prod, unconfirmed. Every card settlement on the books is test money.
- Crypto invoices from an agent: On prod, with every one still pending
- Moves to draw: settled money received through ONE, split into card and crypto. On every page it is the same figure as Money received above the map (on ONE's page, the books fence), and a test pins it. Pending is "on the way" and never added. Credits received are a separate figure.
E · Spend: buying.
- Pay for models and tools in credits (
credits:spend): Live - Buy a plugin with credits: Live (credits, never dollars)
- Buy from a ONE shop (
one shop buy): On prod. Escrow is not on mainnet. - Trade on Hyperliquid (
one hl): On prod - Spend anywhere (
/buy: gift cards, shipped orders, a card per agent): On dev, demo only./buyanswers 404 on one.ie, and nospend:*receiver exists. - Moves to draw: credits used in the last 30 days (in credits), and dollars this group paid as a buyer.
F · Money out: cash out.
- Cash out to your bank (
/off): On dev, demo only./offanswers 404 on one.ie, and no partner is signed. - Sellers paid their share: Stripe Connect pays the seller directly, and
payout:get/payout:setare On prod. No payout has been requested. - ONE never holds seller money.
- Moves to draw: none today, so the
/offpath is drawn as a labelled example.
G · Credits: the metered unit.
- One writer prices every turn: Live
- Each burn carries its provider cost in dollars: On prod, partial. Burns since late September carry it, and earlier ones do not.
- Grants for plans, top-ups and sponsorships: Live
- The daily drift check that warns: Live (the cron is on prod)
- Monthly allocation, usage alerts, auto top-up: On prod, switched off (flags unset)
credits:cap,credits:usage,plans:margin: Designed. None is in the registry.- A starter grant for every enrolled agent: Not started (the variable is unset)
- Moves to draw: the balance and the use over 30 days, in credits. Never with a
$.
H · Agent economy: agents pay agents.
- Offer → escrow → deliver → settle (
market:*): On prod, test money only - Escrow on mainnet: Not started
- Moves to draw: none live, so the path is drawn as a labelled example, marked test.
I · The books: what it means.
- Provider cost per model call: Live
- The books fence,
finance:health,finance:pnl, the books on this page, the sheet and its CSV,oneie finance, health alerts to the owner, and real revenue on the Revenue page: On dev./api/finance/healthanswers 404 on one.ie. - A double-entry ledger, unit economics, runway and forecast: Designed
- Moves to draw: ONE's page only, behind the books gate: the eight health numbers and the P&L. Other groups: the station's words, with no numbers.
J · Proof and duty: receipts and tax.
- x402 payments carry a verified chain digest: Live
- A refund door for the card-paid offer: On dev (3c09aed0a, not wired)
- Invoices an accountant can use: Not started.
wallet:invoiceis a request to be paid, not a tax invoice. - Tax, VAT and the Hong Kong company books: Not started
- Moves to draw: none this round. A list of live payments with their chain link is a new read, and it waits for its own row.
Rules for the map
- The structure may be public. The moves may not. What each station is and its status words can show to anyone who can open the page. A move, meaning any number about this group's money, shows only to whoever the page's own authorization admits. On ONE's own page that is the books gate. The map never widens who may read.
- A move carries its source and its read time, like every number on the page. A move whose read failed says "Not available". It never draws an empty path as if nothing moved.
- An example is labelled as an example on the station itself, with the words used on
/on,/offand/buy. It reusescomponents/demo/path-rail/PathRail.tsxand those pages' demos. - The status words live in one data file that the map reads, not in the component, and they are true only for the build they were checked against. The file pins
checkedAgainst: 'e45681261', and the page prints it beside the words ("status checked against the production build of 16 Nov"). The release that ships this page also ships/on,/off,/buyand the books, so the status check (each item's file or receiver, looked up in the prod sha and in origin/dev) becomes a committed script. Release-manager reruns it, and updates the data file andcheckedAgainstin the same release. Engineering wires it in. A registry test is only a guard against typos: dev's registry already holds the dev-only receivers, so it cannot tell On dev from On prod. - A move's label says what it measures. It never reuses the station's title as if it were the amount: C's title is "Money in", and its move is "Credits you bought". Money received lives on D.
- No count is typed. Counts in this section stay out of the page. The page reads its numbers when it renders.
Style
The one look every finance component follows. Design owns this section. The map leads the look, and every other section borrows from it.
Measured on 2026-11-16 at 20:06 UTC. /u/one/finance answered 200 at
1440 and at 390, with every D1 read timing out. The page draws two styles
at once:
- The glow card: Hero "Received through ONE"
(
FinanceDashboard.tsx) and Hero "Credits available" (CreditsDashboard.tsx). Aforegroundcard with a soft glow from its top-right corner, one big number and a quiet label. This is the most beautiful thing in finance, and it is the model. - The flat Overview card: the health KPIs (
BooksSection→Kpi) and the sheet (FinanceSheet→Card). These arebg-backgroundcards with 11px uppercase labels. They sit at the canvas level, so they look sunk beside the glow cards. These follow the model.
And one defect: an unread number prints the dev diagnostic in the card body ("remote binding unreachable: DB.prepare()…"), five lines deep. That breaks every card it touches.
The model, in classes
Every section is one card. No section draws its own background, and the page canvas is untouched.
| Part | The law |
|---|---|
| Card | relative overflow-hidden rounded-2xl border bg-foreground, borderColor: var(--color-border), boxShadow: var(--shadow-card) (cardClass / cardStyle in demo/path-rail/PathRail.tsx; import them, don't copy them) |
| Glow | one per card: radial-gradient(120% 140% at 100% 0%, color-mix(in oklab, var(--color-<tone>) N%, transparent) 0%, transparent 55%). N is the run's own on Accounts and Received (left as drawn), 14 on the map, 8 on every book card |
| Tone | primary for money and holdings. tertiary on Testnet, with the existing dashed tertiary border (netCardStyle). destructive at N=8 only on a card whose number crossed its line (margin below zero, drift above zero) |
| Padding | p-5 on a card, p-5 sm:p-7 on a lead card. Gaps: gap-4 sm:gap-5 between cards, gap-3 inside one |
| Section header | h2 text-sm font-semibold text-font. On the right, read HH:MM UTC in text-xs text-font/50, then the reread icon. The same header on every section |
| Label | text-sm font-medium text-font/60, with a lucide Icon md in the tone colour. Not uppercase, not 11px |
| Lead number | text-4xl sm:text-5xl font-bold tracking-tight tabular-nums, compact above seven digits (§ One rhythm) |
| Card number | text-3xl font-semibold tracking-tight tabular-nums leading-none |
| Unit | after the number in text-lg text-font/50 ("credits"). Credits never wear $ |
| Sub-line | text-sm text-font/50, one line |
| Meta | source and freshness in one line, text-xs text-font/50 truncate |
| Chip | rounded-full px-2 py-0.5 text-[10px] font-medium uppercase tracking-wide. Warn is bg-destructive/10 text-destructive. Test is bg-tertiary/15 text-tertiary. Example is ExampleChip from the path-rail kit |
| Buttons | primary rounded-xl bg-primary px-4 py-2.5 text-sm font-semibold text-on-primary; secondary is the same shape with border bg-background text-font |
| Table | inside its card. Header text-xs text-font/60. Rows border-t in var(--color-border). Numbers right-aligned, tabular-nums. Under 640px the month prints as Nov 2026 |
Not available
ONE's ruling, after Tony saw raw errors on every card: a failed read
never prints an error, a file, a call or a binding, anywhere on the page.
no-raw-error.test.tsx holds it.
The number's slot says plain words in text-xl font-semibold text-font/40,
small enough to fit a two-up card at 390:
- a books figure: Not read: the books did not answer
- an accounts figure: Not available
- a chip or a move on the map: On the way: not read
Below it goes one line, text-xs text-font/50: the source and the time
it was tried, for example the books · D1 · tried 03:41 UTC. The card keeps
its frame, its height and its glow. A section whose reads all failed keeps
its frame and shows one such line.
The money map
The map is the centrepiece and closes the books, below the run (§ Order on the page). Its structure is public; its moves follow § Rules for the map.
Desktop (lg and up): the flow drawn as nodes, in the order finance.md
draws it.
[your bank]
│
[C money in]
│
[A hold]
│
[B limit]
┌────────┼────────┐
[E spend] [D get paid] [H agents]
│ │ │
[G credits] │ │
└────────┼────────┘
▼
[B come home]
┌────────┴────────┐
[F money out] [I the books]
│
[J proof]
B is one station drawn at two points: the limit and the walk home. G hangs off E because credits are what E spends. J hangs off I because the proof is the books' paper.
Phone (below lg): one column, A to J, each station a row on a vertical line, in the same flow order. Never shrink the desktop map.
A station node: rounded-xl border bg-background px-3 py-2, its
letter in a 24px circle, its name in text-sm font-semibold, and its
question ("who holds it") in text-xs text-font/50. On the right sits
the status dot. The node lit by the walk gets border-primary, a
ring-2 ring-primary/25, and the tone glow at 8%.
Status, from the five words, never from colour alone: each node prints the word beside its dot.
| Word | Dot | Node border |
|---|---|---|
| Live | filled tertiary |
solid |
| On prod | outlined tertiary |
solid |
| On dev | outlined primary |
solid |
| Designed | outlined font/30 |
dashed |
| Not started | none | dashed, node at opacity-60 |
When the only money is test money, a Test chip sits beside the word.
Edges are CSS lines, never a graph library: 1px in
var(--color-border). An edge with a real move for this reader is 2px
primary and carries one chip on the line: the amount, its window and
read HH:MM. An example edge is 1px dashed with ExampleChip. A move
whose read failed keeps its line plain and its chip says "Not available".
No motion beyond var(--ease), and no flowing dots.
[your bank] is not a station. It is a plain label with no node frame,
where money enters from outside.
The map card's header reads Money map on the left. On the right is
the status file's stamp, checked against prod e45681261 · <date>, in
text-xs text-font/50, read from the data file and never typed.
Walking it (the screen law). Below the drawn map, in the same card, sit
three columns at lg, laid out as on /on:
- the path-rail kit's
PathRailon the left, stops A to J by letter and name; - the station card in the centre: what it does, then its items grouped by status word with Live first, then the moves or the labelled example;
- the kit's
OneLineon the right, with ONE's one line for the station.
Back and Next walk A to J. The rail, a node click and the URL hash
#station-c all choose the same station, and the lit node follows. Below
lg the rail becomes the kit's one-line stepper and the OneLine drops
under the station card, as on /on. The chat beside the page never
redraws the map.
Order on the page
Tony's ruling (2026-11-17), the last word on this page: the run of Accounts → Received with its money line → Your path is "the most beautiful financial dashboard". That run is the style. It stays exactly as it looks, and everything below it is made to match it.
- Page header, one row. The h1 Finance on the left, with Buy credits
and Sell on its right. No button sits between sections. The network
switch stays in the breadcrumb row above (
NetSlot, the shared switch on/wand every finance page), so a person meets one switch in one place. It is never forked into this header. - The run, untouched. Accounts (Credits · Wallets · Card payments),
then Received with its money line, with Your path beside it, as drawn
today in
components/finance/dashboard/**. No restyle and no word cuts. The one exception is a number its card cuts off ("999,201,3…"): that is broken, not a look, so it prints compact (§ One rhythm). - The books, below the run, in its style. The health sentence with its 7 / 30 / 90 pill, the money row, the watch row, the P&L sheet, what the books cannot say yet, then the money map. They are never above the run.
- No "Everything in Finance". The room tiles leave this page.
lib/navigation.tsand the other room pages are untouched.
One rhythm, top to bottom
Measured at 1440 on 2026-11-16 at 21:20 UTC with live data. Every rule below copies the run's own anatomy onto the books.
| Part | The law |
|---|---|
| Card | the run's card: bg-foreground rounded-2xl border, shadow-card, its corner glow. The books' cards use the 8% glow; the run keeps its own |
| Section | an h2 header row, then its cards. mt-10 between sections; gap-4 sm:gap-5 inside one, the run's own gaps |
| Label | the run's label: text-sm font-medium text-font/60 with a lucide icon. The 11px uppercase labels go |
| Sub-row label | "Money" and "Watch" in text-xs font-medium text-font/50, flush with the cards' left edge |
| Number row | the eight health numbers, four-up at lg and two-up at 390, number text-3xl font-semibold tabular-nums |
| Heights | every card in a row is the same height (h-full on the grid item) |
| A number never clips | above seven digits it prints compact (999.2M credits), with the exact figure in its title. A number is never cut by its card or by truncate |
| Digits | thousands separators always (5,468 calls, 100,000,000 credits), and plurals agree with the count (1 grant) |
| No ellipsis | in the books, a line that does not fit is shortened to fit, not cut off with "…". The full sentence goes in the title |
| Meta | the window or the freshness only (30 days, now). The source goes in the number's title |
| Chips | one line, at most two words after the icon: Below zero, Above 5%, Above zero |
| Health sentence | the header of the books' first section, with the 7 / 30 / 90 pill on its right. The pill governs the books only |
| The keys line | "Your accounts, your keys. ONE never holds your money." goes once, at the foot of the page |
Fewer words, in the books only: cut every line that restates the header
or the chip. "Every cell is a read of the books…" under P&L goes (the header
says read HH:MM UTC). The budget row reads Budget · not built yet with a
lock, and its row id moves into the title.
Don't
- Don't use a
bg-backgroundcard for a section. That is the canvas level. Inputs and map nodes sink to it; cards don't. - Don't add a second glow, a gradient border or a tinted card header.
- Don't print
$beside credits, or a status as colour with no word. - Don't build a second rail, chip or demo kit.
demo/path-railis the kit. - Don't put a diagnostic in a card body.