docs(rust): protocol 14 — Economics, as built (PROTOCOL §20.3, PLAN_REDESIGNS §11.2.4) #339

wtclaude · 2026-10-12T12:16:30Z

wtclaude commented

2026-10-12 12:16:30 +00:00

What & why

The spec and the record for the Economics build (PLAN_REDESIGNS.md §11.2), alongside Rust-Plugins, Rust-Link, Module-Rust and Android-app PRs on the same feature.

rust-link/PROTOCOL.md §20.3 covers:
- integrations.economics;
- economics.pay / .balances / .adjust, with their replies and refusals;
- the tally's balance: a value, and a nameless frame is an offline player;
- economics.wiped, with newSave;
- the three sidecar forwards, and the website's half.
§20's heading now reads "the step editor and the optional plugins".
modules/rust/PLAN_REDESIGNS.md §11.2.4 Built records that the bridge compiled on both rigs, which were then given back protocol 13. It names six points the design left open that the code settled, so any of them can be overruled:
1. economics.wiped carries newSave. A new save clears nothing; ecowipe clears the wipe's balances.
2. A balance frame with no name is not play, and moves nobody's last-seen.
3. The Coins column is per wipe only; there's no all-time balance.
4. A payment's failed reasons are at-limit, refused, unmeasured and bad-id.
5. Payment and adjustment keys are kept apart, and the admin form sends a fresh key per submission.
6. A new rust.coins budget, priced like the kit reward.
android/PLAN.md: the Rust account row gains GET /player/rust/economics.

How it was tested

Docs only. The described behaviour is covered by the code PRs' tests, and the walk is deferred to the end of the plan (D331, §11.2.3).

Checklist

I have read CONTRIBUTING.md.
The change builds and existing tests/checks pass locally.
I have added or updated tests/docs where it makes sense.
My commits are reasonably scoped with clear messages.

AI-assisted contributions (required)

No AI tools were used to produce this contribution.
AI tools were used. Tool(s): Claude Code (Claude Opus 5.5). I have reviewed and understand
every change, and take responsibility for it. AI-authored commits are
marked with a Co-Authored-By / Assisted-By trailer.

License

I agree that my contribution is licensed under this project's license
(GNU GPL v3.0 or later), and I have the right to contribute it.

🤖 Generated with Claude Code

https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

## What & why The spec and the record for the Economics build (`PLAN_REDESIGNS.md` §11.2), alongside Rust-Plugins, Rust-Link, Module-Rust and Android-app PRs on the same feature. - **`rust-link/PROTOCOL.md` §20.3** covers: - `integrations.economics`; - `economics.pay` / `.balances` / `.adjust`, with their replies and refusals; - the tally's `balance`: a value, and a nameless frame is an offline player; - `economics.wiped`, with `newSave`; - the three sidecar forwards, and the website's half. §20's heading now reads "the step editor and the optional plugins". - **`modules/rust/PLAN_REDESIGNS.md` §11.2.4 Built** records that the bridge compiled on both rigs, which were then given back protocol 13. It names **six points the design left open that the code settled**, so any of them can be overruled: 1. `economics.wiped` carries `newSave`. A new save clears nothing; `ecowipe` clears the wipe's balances. 2. A balance frame with no name is not play, and moves nobody's last-seen. 3. The Coins column is per wipe only; there's no all-time balance. 4. A payment's `failed` reasons are `at-limit`, `refused`, `unmeasured` and `bad-id`. 5. Payment and adjustment keys are kept apart, and the admin form sends a fresh key per submission. 6. A new `rust.coins` budget, priced like the kit reward. - **`android/PLAN.md`**: the Rust account row gains `GET /player/rust/economics`. ## How it was tested Docs only. The described behaviour is covered by the code PRs' tests, and the walk is deferred to the end of the plan (D331, §11.2.3). ## Checklist - [x] I have read [CONTRIBUTING.md](CONTRIBUTING.md). - [x] The change builds and existing tests/checks pass locally. - [x] I have added or updated tests/docs where it makes sense. - [x] My commits are reasonably scoped with clear messages. ## AI-assisted contributions (required) - [ ] No AI tools were used to produce this contribution. - [x] AI tools were used. Tool(s): `Claude Code (Claude Opus 5.5)`. I have reviewed and understand every change, and take responsibility for it. AI-authored commits are marked with a `Co-Authored-By` / `Assisted-By` trailer. ## License - [x] I agree that my contribution is licensed under this project's license (**GNU GPL v3.0 or later**), and I have the right to contribute it. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

wtclaude added 1 commit 2026-10-12 12:16:32 +00:00

docs(rust): protocol 14 — Economics, as built (PROTOCOL §20.3, PLAN_REDESIGNS §11.2.4) 6fad1f07af

PROTOCOL.md §20.3 specifies what §11.2.2 designed and the code now does:
integrations.economics, economics.pay / .balances / .adjust and their replies
and refusals, the tally's `balance` (a value; a nameless frame is an offline
player), economics.wiped with `newSave`, the three sidecar forwards, and the
website's half. §20's heading now covers the optional plugins too.

PLAN_REDESIGNS §11.2.4 records the build (compiled on both rigs, then given
back their protocol 13 bridge) and names the six points the design left open
that the code settled, so the org lead can overrule any of them. The app
plan's Rust account row gains GET /player/rust/economics.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01E14m6SuuY6i1vASFeGDBeY

whitlocktech merged commit de29c7cbd9 into main

2026-10-12 12:40:06 +00:00

whitlocktech referenced this issue from a commit

2026-10-12 12:40:07 +00:00

Merge pull request 'docs(rust): protocol 14 — Economics, as built (PROTOCOL §20.3, PLAN_REDESIGNS §11.2.4)' (#339) from docs/rust-protocol-14-economics into main

whitlocktech deleted branch docs/rust-protocol-14-economics

2026-10-12 12:40:07 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: RunicGateway/docs#339