From 9496c26a25b66abedf412569ad9a593462201336 Mon Sep 17 00:00:00 2001 From: jvanvik Date: Mon, 9 Nov 2026 23:05:16 +0100 Subject: [PATCH] Plans: what the batch of 2026-11-09 built, and what it decided not to next-session.md listed the batch as in progress. It now lists the nine commits with what each built and what its builder left out on purpose, folds in the IPv6-only row's notes (item 4 is built; the NAT64 ratio is not in the standard; a swap starts only with all of it to spare) and the wave rule (dfWaveCust()), and keeps one small follow-up: two standing-order descriptions still say no customer may ride a swapped fiber. ARCHITECTURE's IPv6-only row names the build standard's v6 row. --- docs/ARCHITECTURE.md | 2 +- docs/plans/next-session.md | 78 ++++++++++++++++++++++++++------------ 2 files changed, 54 insertions(+), 26 deletions(-) diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index db08733..9891984 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -104,7 +104,7 @@ build stays the static page described above. | `src/game/60-features/96-pop-standard.js` (grown from upstream's POP standard), `src/game/90-actions/88-build-standard.js`, `src/game/93-ui/59-build-standard.js` | The build standard: one target for every POP, port and fiber (`BSTD`, saved sparse in `S.popStd`), what is below it and what bringing it up costs (`bstdPlan()`, `bstdQuote()`), the sheet, "Bring everything up now" (`bstdApply`) and the intern's "Keep to the build standard" order (`std`, in `95-standing-orders.js`). The router model and the line system are picked here and nowhere else | | `src/game/93-ui/15-theme.js`, `src/styles/05-theme.css`, `src/game/96-map/15-palette.js` | Dark mode (#80): Light, Dark or Auto per device (`sot-theme`), set on `` before the first paint; the panels' dark colours as CSS custom properties; the map's colours per theme | | `src/game/60-features/33-address-space.js`, `src/game/90-actions/54-address-space.js`, `src/game/94-dashboard/72-address-space.js` | IPv4 address space (#150): blocks held, bought, leased in and leased out (`S.ip4`), customers' blocks, CGNAT and its ratio; the bank's Address space section | -| `src/game/60-features/34-ipv6-only.js`, `src/game/90-actions/55-ipv6-only.js` | IPv6-only broadband: a city's home routers swapped for 464XLAT, and the NAT64 pool next to CGNAT | +| `src/game/60-features/34-ipv6-only.js`, `src/game/90-actions/55-ipv6-only.js` | IPv6-only broadband: a city's home routers swapped for 464XLAT, and the NAT64 pool next to CGNAT; the build standard's `v6` row rolls it out (`ip6Todo()`, `ip6Owed()`) | | `src/game/80-simulation/65-express.js`, `src/game/90-actions/87-express.js`, `src/game/93-ui/72-express.js`, `src/game/96-map/51-express-geometry.js` | Express lightpaths (#58): a link of kind `xp` from A to C over a chain of ROADM fibers, passing the cities between as light; its rules, actions, panels, the link window's Express tab, and how the map draws it | | `src/game/10-catalog/75-satellites.js`, `src/game/60-features/45-teleports.js`, `src/game/90-actions/87-teleports.js`, `src/game/93-ui/72-teleport-panels.js` | Satellites (#83): teleports at POPs (`p.tele`) and rented GEO and MEO circuits (links of kind `sat`): the birds and their reach, the rules and money, the actions and the panels | | `src/game/60-features/89-multiplayer.js`, `src/game/95-modals/48-multiplayer.js`, `src/game/90-actions/92-multiplayer.js`, `src/styles/41-multiplayer.css` | Multiplayer, only in a copy built with `MP_API` ([MULTIPLAYER.md](MULTIPLAYER.md)): `S.mp`, saves and cards sent to the session server, the `#mp=` link; the title screen's door, the session panel and the HUD chip; `srvOn()`, false until server-run play is switched on | diff --git a/docs/plans/next-session.md b/docs/plans/next-session.md index d1228d9..f10851d 100644 --- a/docs/plans/next-session.md +++ b/docs/plans/next-session.md @@ -1,7 +1,7 @@ # What is left (as of 2026-11-09) -Work in this fork, pushed to the `vanvik` Forgejo remote (never to `origin`). `main` is at 3e30621. Nothing below is -switched on or built unless it says so. +Work in this fork, pushed to the `vanvik` Forgejo remote (never to `origin`). Written on top of 3e30621, with the +batch of fixes below ("Built in the batch of 2026-11-09"). Nothing below is switched on or built unless it says so. ## Built so far @@ -23,6 +23,40 @@ faster routing (3.3.0)"; earlier merges 032470f and 4b922ab): 72f31e8, 3b8c331, 9597d89, 77f4035 and 3e30621. The design, its status and what building T2 changed in it are in `docs/plans/server-run.md`. +### Built in the batch of 2026-11-09 + +Nine commits after 3e30621 (and the one that wrote this list); every code change comes with its test: +- 8068a45 "Plans: the server-run design in the repo, what is left now, and the fork's files" (this file, + `server-run.md`, the fork's files in `ARCHITECTURE.md`, a note in `MULTIPLAYER.md`). +- **Dark mode (#80)**, 27ffa33: red text is `--tx-red` (a lighter red at night) everywhere it is text, in the styles + and in 19 game files; fills, borders and bars that carry white letters keep `--bad`. The market's Hot and Cool tags + take `--tint-o`/`--tx-amber` and `--tint-b`/`--tx-blue`. `tests/dark-mode.test.js` fails on any new + `color:var(--bad)`. Decided not to: light mode's `--bad` on white (3.24, under AA) stays as upstream has it. +- **IPv4 (#150)**, 7930d33: IPv4 notices in the notification log open the Address space (log target `{a:'ip4'}`, + `ip4Open` in `NOC_GO`); with IPv4 off since, they open the bank. +- **Satellites (#83)**, 2dc8274: the "no subsea cable lands here" hint (#321) names a satellite circuit where one can + reach the city, with a "From X" button per teleport to the order sheet (`satNoCable()`), or where a teleport would + have to go. It covers only the city the hint names. +- **Express fiber (#58)**, ae78e82: a regen site added later charges a regen card per express channel on its fiber + (`regenAddCost()`, used by the action, the button's price and the MCP quote); a dirty connector (loss with + `glass:true`) dims every express on the fiber (`xpGlassF()`), and the express panel names the fiber. Decided not to: + an MTU mismatch, microbursts and a marginal optic's CRC errors stay with the fiber's own routers and optics, which an + express passes by (as an optic failure already did, while amp-hut and ROADM incidents darken expresses). +- **Satellites (#83)**, 1f76639: selective networks refuse to peer where a satellite circuit is the island's or + town's only way out (`satOnly()`): 60 in 100 refuse a GEO hop, 15 in 100 a MEO one, each network's answer fixed; a + session already there stops carrying until a wave or cable is lit. Decided not to: a worse traffic ratio for MEO, + refusals at exchanges you run, and any effect on PNIs already there. +- **Build standard**, 286ae48: "Bring everything up now" and the intern follow one rule: a fiber a customer's alien or + managed wave rides keeps its line system (`dfWaveCust()`), and the sheet says why (`bstd.held_wave`); leased pairs + and IRUs no longer hold a fiber for the intern. Left as it was: the fiber panel's own upgrade button (`ACT.upSys`) + still swaps under a sold wave, with its warning toast. +- **Standing orders**, 02b6c24: the shift's log keeps at most three broken orders, the week's tally no longer makes an + empty list of places, and `opsTidy()` is gone (`tests/canonical-state.test.js` passes without it). +- **IPv6-only broadband (#150)**, 417160f: the build standard's "Broadband: IPv6-only" row (`BSTD` `v6`, shown only + while `ip4On()`). `bstdPlan()` makes one job per dual-stack broadband city (`ip6Todo()`), the most dual-stack homes + first, priced as the whole swap (`ip6Cost()`); the button and the `std` order start one only with all of it above + the floor on top of what running swaps still owe (`ip6Owed()`), and the order counts it against its month's budget. + ## The user's answers (2026-11-09) The four questions of the server-run design: @@ -70,23 +104,10 @@ Asked on 2026-11-09, not answered yet: ## Next -- **In progress** (another builder is on these right now): - - the build standard's "Bring everything up now" and the intern follow one rule for fibers that carry sold alien or - managed waves (today the button can take such a fiber dark for a day, while the intern refuses any fiber with a - customer, leased pairs and IRUs included, which a line-system swap cannot hurt); - - dark mode: the capacity market's hot and cool tags, and red `--bad` text that is below AA contrast on dark cards; - - IPv4 notices in the notification log get their "Address space" button; - - the "no subsea cable lands here" hint (#321) mentions a satellite circuit where a teleport can reach the city; - - express fiber: a regen site added later charges for the express channels on its fiber, and loss incidents on a - fiber reach the expresses on it; - - selective peers react to peering that rides a GEO link; - - the intern's two small standing-orders fixes in `opsRun()` (the shift's log keeps an uncapped list of broken - orders, and the week's tally makes an empty list of places for a job that names none); `opsTidy()` stays after the - shift until `tests/canonical-state.test.js` passes without it; - - IPv6-only broadband in the build standard: a "Broadband: IPv6-only" row, with the intern's `std` order rolling it - out busiest CGNAT cities first (`ip6Go`/`ip6Stop` are in `src/game/90-actions/55-ipv6-only.js`, the panel and day - logic in `src/game/60-features/34-ipv6-only.js`; the row goes into `BSTD` and `bstdPlan` in - `src/game/60-features/96-pop-standard.js`). +- **Small follow-ups from the batch** (none needs the user's go): + - the standing-order descriptions `ops.o_std_around_d` and `ops.o_optup_std_d` still say a line system changes only + where "no customer rides it"; that is now true only of wave customers (leased pairs and IRUs no longer hold a + fiber). Rewording needs new labels and six translations. - **After the user's go:** T3 (host and protocol), T4 (the browser client) and the integration of server-run play, as `docs/plans/server-run.md` describes them, with the corrections at its top. That includes the Q1 work: the game's `S.day0` and day-0 rules, a start day for a new network on the server, and `CLOCK.off` taken out of the contract. @@ -110,7 +131,10 @@ Asked on 2026-11-09, not answered yet: 3). The sheet's quote and "Bring everything up now" judge a line-system swap without routing (`bstdDarkOk()`: a quiet fiber, under 10% of its capacity, or a parallel link with room; any express with traffic holds its fibers, `bstdXpBusy()`), so the quote is the bill; only the intern routes to test. A quiet fiber with no way around can - still go dark from the button for a day. An old save's `routers.model` moved into the standard (only from a running + still go dark from the button for a day. A fiber a customer's alien or managed wave rides keeps its line system for + both the button and the intern (`dfWaveCust()`); the fiber panel's own upgrade button still swaps it, with only a + toast to warn. `bstdSet` accepts the `v6` target while IPv4 is plentiful: it is saved, hidden and never planned. An + old save's `routers.model` moved into the standard (only from a running order with an intern hired; a paused one's is dropped) also becomes what new POPs get. A model or line system in the standard is a ceiling for the `routers` and `optup` orders (their next-one-up rule only applies with "keep"), as an order's own model was before; `optup` has no per-POP exceptions, so it moves fiber at POPs excepted from `std` too. @@ -120,15 +144,19 @@ Asked on 2026-11-09, not answered yet: weeks); lease-out income is not in the investor revenue share (open question 7); blocks granted to old saves can be sold after two years (a one-off windfall); CGNAT annoyance costs refunds but does not slow broadband growth. - **IPv6-only broadband:** no one-off grumble while a city's home routers are swapped; a new home in an IPv6-only city - pays its router even when cash is short (a running cost, so a finished city never looks like a stopped swap). + pays its router even when cash is short (a running cost, so a finished city never looks like a stopped swap). The + NAT64 ratio is not in the build standard (the swap is), and the standard starts a swap only with the whole of it to + spare, stricter than the city panel's button (the first day's routers). - **Express fiber (#58):** a whole fiber pair does not splice through a city (every fiber end is a POP; expresses - cover the need; open question 5). + cover the need; open question 5). Of a fiber's own incidents only the dirty connector dims its expresses; MTU, + microbursts and a marginal optic stay with its routers and optics. - **Satellites (#83):** no WISP zones and no rented LEO tier (open question 6); the rented GEO and MEO circuits never fail (no rain fade or sun outage; Pie in the Sky has its own); no island volcano or Caribbean and Pacific hurricane events; no "Island Hopper" scenario; no footprints on the map; no satellite tab in the drag-to-link window (ordering - is from the city panel); GEO/MEO losses and prices are design numbers; well-cabled islands (Wellington, Hobart) also - count as "can be served"; MEO needs 5° elevation (10° would drop 416 pairs); Pitcairn's $120k satellite grant stays - Pie-only. + is from the city panel; the no-cable hint offers a teleport's order sheet only for the city it names); selective + networks judge a satellite-only island by fixed shares (60 in 100 refuse GEO, 15 in 100 MEO), not by its traffic; + GEO/MEO losses and prices are design numbers; well-cabled islands (Wellington, Hobart) also count as "can be + served"; MEO needs 5° elevation (10° would drop 416 pairs); Pitcairn's $120k satellite grant stays Pie-only. ## Housekeeping