v0.8.2 — every district opens on a Depot, and the docs are pages now

A second-digit bump for a playtest read back against the save file. Nine questions
were asked of one three-Day game; three were bugs, three were the rules working
and undocumented, three were decisions. Every save on the test server was replayed
against this build BEFORE release, which is how the cost of each rule was known
before it was chosen rather than discovered after.

EVERY DISTRICT OPENS ON A DEPOT. A Whistle Post has one A/D track and is not a
Passenger Facility, so the opening of every game was spent unable to work a
passenger and one arrival away from a collision. Two A/D tracks and passengers
from Stage 1 now; "Players start with Whistle Posts, not Depots" is the harder
game, set when the game is created. The deck follows the choice — starting on
Depots the four Depot upgrade cards are left out, because an upgrade must be to
the next tier and a Depot card at a table of Depots is a dead draw. How much
easier it is showed up as a test failure rather than an argument: the cue-coverage
pool needed widening from 24 seeded games to 60 before it held one collision.

NO SAVE WAS STRANDED BY IT, which took care. This is the one house rule that
changes how a game is DEALT rather than how it plays, so replaying a save under
the wrong opening is a different railroad from intent one — silently, with no
error. `withSavedOpening` fills it on the replay paths ONLY. Putting it in the
resolver instead made a fresh Cutthroat game deal Whistle Posts and read as
Custom, which is how the distinction was found.

THREE BUGS, ALL REPORTED FROM ONE GAME AND ALL CONFIRMED ON ITS SAVE.

An Office held TWO TRAINS ON ONE A/D TRACK. The capacity test passed with nothing
standing, the train the Interlocking had been holding at the Limits was moved into
the free slot, and the arriving train was pushed in after it without anyone asking
again whether there was room — so the collision §8.3 calls for never happened. The
held train keeps priority; the newcomer now takes the consequence it would have
met had the held train arrived first.

THE HISTORY FROZE, permanently, and the log cap was not really the cause. Each
seat's "what have I sent you" bookmark was an INDEX into an array the game trims,
so once a seat's bookmark reached the limit the slice returned nothing for the
rest of the game — at a different moment per seat, because each holds its own.
That game's log ended at exactly the cap. Lines carry a sequence number now, which
survives trimming; proven by pushing twice the cap through a simulated seat.

§8.1 ASKED THE WRONG QUESTION TWICE. "Trains may pass" returned `clear` before the
Subdivision was looked at, so a train entering a Double Track was released however
busy the rest of it was — that, not anything about Control Points, is what let
Train 8 out with no ruling. And a train standing at an Office was invisible to the
scan, so one about to re-enter the very Subdivision being entered counted for
nothing. Capacity is the test, not presence: a Depot with a track free is not in
the way; a Whistle Post with its one track taken is.

THINGS THAT HAPPENED SILENTLY NOW SAY SO — a train held against a facing one, a
train released from the Limits (a side effect of somebody else's arrival, so it
simply appeared at the Office), and the train an Interlocking is holding, whose
explanatory tooltip has existed since #99 with NO renderer ever reading the flag.

WHERE A MOVE IS REFUSED, AND WHY. `exploreMoves` decides where the rails go and the
pick-up restrictions are enforced afterwards in `check`, so a square the rails
reached and the card forbade was reachable, un-offered, and absent from the block
list with nothing said. Those squares are blocked with the rule that blocks them
now, and the reasons are got by ASKING `check` rather than re-deriving: a second
implementation of the rules is exactly the failure the block list exists to avoid.
A train may also always recover its own caboose — X13 prints "may drop but not
pick up anything", and a train needs its caboose to be made up, so one that parted
with it could never legally leave again.

RULES DECIDED IN SEPTEMBER AND APPLIED HERE. A Modifier must sit square against its
host, no diagonals. A passenger Modifier may not be played at a Whistle Post. Both
were built, measured, held back for a fortnight so a playtest could finish, and
applied now. A Second Section costs its card: `SECOND_SECTION` was declared in
content.ts and never dealt, so the action was free and the bot ordered 26
accidental ones in a measured round. The card is dealt and spent — gating on a card
the deck never holds would have deleted the mechanic rather than fixed it.

THE DOCUMENTATION IS A SET OF PAGES, not five text files served as text/plain — a
card reference is mostly tables, and as plain text a table is rows of pipes.
Markdown is still the one copy; the build renders it, and publishes the .md beside
each page. No Markdown library: this project has no runtime dependencies and one
would be a poor first. The pages add what Markdown cannot carry without drifting —
a nav across the set, a contents list built from the headings actually rendered,
an anchor on every heading, a 70-character measure, and tables that are tables.
They print as ink on paper.

The references caught up with the rules, checked rather than assumed: two
statements had gone from stale to misleading (the Quickstart told a new player to
"get a Depot down as soon as one appears"), and four rules nobody could look up
are written down — the Office tier table, §8.1 in practice, what the Circus Train
pays for, and that a Realignment can be a card with no legal target.

Adding one card to the deck reshuffles every seeded deal, which broke five
fixtures. Each was a seed meaning "a game like this" — TODO #84, exactly — so
seeds moved and pools widened rather than assertions weakening, and the clearance
fixture pins its terrain the way `enhancements.test.ts` already does. The three
published replays were re-recorded.

Closes TODO #40, #42a, #108, #109 and #110.

1046 fast tests and 35 sim tests pass.

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

docs/components.md

@@ -1,8 +1,6 @@
 # Station Master — Components and Markers
 
-**Describes the game as built at v0.8.1.0** (2026-09-22). These references are kept current with
-every release rather than versioned as editions, so there is no version in the filename: this file
-is always the latest, and the build it describes is stated here.
+**Version 0.8.2** · 2026-09-23
 
 **Scope:** non-card physical components and supplies. Card-created facilities, workers, deck piles,
 hand state, timetable state and other markers are documented with their cards or in the
@@ -10,7 +8,7 @@ hand state, timetable state and other markers are documented with their cards or
 
 The figures below are checked against `ROLLING_STOCK_SUPPLY` and the supply constants in
 `src/engine/content.ts`. They are physical inventory rather than deck tuning, which is why they are
-printed here at all — per-category CARD counts are deliberately not published anywhere (TODO #15a).
+printed here at all — per-category CARD counts are not published, because they move with play balance.
 
 ## Rolling stock
 
@@ -33,7 +31,7 @@ The engine is not rolling stock and does not count against the four-car Crew Tra
 | Component | Count | Note |
 | --- | ---: | --- |
 | Crew Trays | players + 3 | Engine and tray are one combined resource; there is no "engine without a tray". |
-| Whistle Post cards | 4 | Every player starts on one; it is not drawn from the deck. |
+| Office cards | 4 | Every player starts on one. The starting Office is not drawn from the deck. |
 | Limits signs | 8 | "2N + spares", so relocating one is never a supply question. |
 
 ## The two yards
@@ -75,10 +73,10 @@ following-train clearance decisions, takes the Yard Office and Red Flag question
 every round round the table starts with. A Mainline collision is their fault by §10, and costs 5
 Revenue. The initial holder is the first player tied for the highest Superintendent setup D12 roll.
 
-It passes at the end of Stages 3, 6, 9 and 12 — every third Stage, at the Supervisor Shift. Since
-v0.8.0.13 the handover is **announced on screen and written into the history**: it is the one thing
-in the game that changes hands on the clock rather than because somebody did something, so nobody is
-watching for it. Note that the Supervisor Shift refreshes every Laborer and Porter *every* Stage
+It passes at the end of Stages 3, 6, 9 and 12 — every third Stage, at the Supervisor Shift. The
+handover is **announced on screen and written into the history**: it is the one thing in the game
+that changes hands on the clock rather than because somebody did something, so nobody is watching
+for it. Note that the Supervisor Shift refreshes every Laborer and Porter *every* Stage
 while the Fedora moves only every third.
 
 ## D12 and seeded randomness
@@ -91,3 +89,30 @@ The D12 is used by the engine for:
 - all shuffled deck order and automatic setup selection through the same seeded random stream.
 
 The rules engine uses a deterministic 32-bit seeded random generator. The same numeric seed, player configuration, house rules, and accepted intent sequence reconstruct the same game. A seed by itself is not enough when house rules differ.
+
+## The Office, tier by tier
+
+Every player has one Office card. It is a property of the district rather than a card that is
+swapped, so an upgrade raises the numbers in place and leaves anything built beside it alone.
+
+| Office | A/D tracks | Porters | Passengers out / in | Control Point |
+| --- | ---: | ---: | --- | :---: |
+| Whistle Post | 1 | 0 | 0 / 0 | — |
+| Depot | 2 | 1 | 1 / 1 | yes |
+| Station | 3 | 2 | 2 / 2 | yes |
+| Terminal | 4 | 3 | 3 / 3 | yes |
+
+**A/D tracks are what decide whether an arrival is a collision.** A train pulling in to an Office
+with every track occupied collides (§8.3) unless an **Interlocking** holds it out on the Limit
+Track. A train held that way takes the first track to free, ahead of anything arriving after it.
+
+**A Whistle Post is not a Passenger Facility.** It has no Porters and no passenger boxes, so nobody
+boards or gets off there however well the district is built, and the passenger Modifiers — Waiting
+Area, Restaurant, Hotel — cannot be played at one.
+
+**A Control Point divides the Mainline into Subdivisions**, which is what §8.1 reasons about. A
+table of Whistle Posts is one Subdivision from end to end; every upgrade splits one in two and buys
+the Division capacity.
+
+**Games open on a Depot** unless the table turns on "Players start with Whistle Posts, not Depots"
+when the game is created. See the Home deck reference.

docs/design.md

@@ -28,7 +28,6 @@ Written to be handed to somebody who is about to play, rather than to somebody b
 | --- | --- |
 | [`quickstart.md`](quickstart.md) | **Start here if you have never played.** The point of the game, how a Stage runs, what is on screen, how you win, a first twenty minutes, and what to report. |
 | [`rules.md`](rules.md) | **The rules in full**, as the engine actually runs them, with a FAQ. |
-| [`rules/as-built.md`](rules/as-built.md) | **Every card, GENERATED from `src/engine/content.ts`** and checked by a test, so it cannot disagree with the game. The table of record for per-card facts. |
 | [`home-deck.md`](home-deck.md) | How the Home Office deck is dealt, drawn and played out. |
 | [`mainline-deck.md`](mainline-deck.md) | The Mainline cards, how the deck is dealt, and what a card does to a train crossing it. |
 | [`components.md`](components.md) | Rolling stock, the two yards, Crew Trays, the Fedora, the D12. |
@@ -45,7 +44,7 @@ described — which read as though they documented a build five minor versions o
 | --- | --- |
 | [`rules/rules-v0.1.md`](rules/rules-v0.1.md) | Faithful markdown transcription of the PDFs. No corrections. The baseline everything diffs against. |
 | [`rules/rules-v0.2.md`](rules/rules-v0.2.md) | **The working ruleset.** v0.1 with all ten gaps resolved, each change marked with its gap number. |
-| [`rules/card-reference.md`](rules/card-reference.md) | **⚠ SUPERSEDED** — an invented 52-card placeholder, kept for its economy summary and its history. For what is printed on every card, read [`rules/as-built.md`](rules/as-built.md), which is generated from the code. |
+| [`rules/card-reference.md`](rules/card-reference.md) | **⚠ SUPERSEDED** — an invented 52-card placeholder, kept for its economy summary and its history. For what is printed on every card, read the generated tables in [`home-deck.md`](home-deck.md) and [`mainline-deck.md`](mainline-deck.md). |
 | [`rules/glossary.md`](rules/glossary.md) | Every defined term, alphabetized. |
 | [`rules/open-questions.md`](rules/open-questions.md) | All thirteen gaps, each with the options considered, the decision, and the rationale. |
 | [`rules/implications.md`](rules/implications.md) | **Read this first.** What the four recovered design files (`Deck cards2.xlsx`, `Mainline Cards.pdf`, `Trains3.pdf`, `tracks.png`) change — and which decisions they supersede. |
@@ -68,7 +67,7 @@ must do.
 
 ## Current status
 
-**v0.8.1.0.** Rules formalized, card faces specified, architecture documented, and the game
+**v0.8.2.** Rules formalized, card faces specified, architecture documented, and the game
 playable **solitaire and multiplayer** in a browser against an authoritative server. See
 [`../CHANGELOG.md`](../CHANGELOG.md) for what each version changed and [`../TODO.md`](../TODO.md) for
 what is open; this section is the shape of the project, not a running tally, because a
@@ -109,8 +108,9 @@ TypeScript natively, so there is no build step during development, which also me
 only**: no `enum`, no parameter properties, no namespaces.
 
 Running alongside, and independent of all of it: **print-and-play components.**
-[`rules/as-built.md`](rules/as-built.md) carries every card face as the game actually deals it, so
-layout and art are the only remaining work before a table playtest — which answers the one question
+The generated tables in [`home-deck.md`](home-deck.md) and [`mainline-deck.md`](mainline-deck.md)
+carry every card face as the game actually deals it, so layout and art are the only remaining work
+before a table playtest — which answers the one question
 simulation cannot, whether it is fun.
 
 Run the harness with `node src/sim/harness.ts [games] [length]`.

docs/home-deck.md

@@ -1,22 +1,18 @@
 # Station Master — Home Deck
 
-**Describes the game as built at v0.8.1.0** (2026-09-22). These references are kept current with
-every release rather than versioned as editions, so there is no version in the filename: this file
-is always the latest, and the build it describes is stated here.
+**Version 0.8.2** · 2026-09-23
 
 **Scope:** the Home Office deck — how it is dealt, drawn, discarded and reshuffled, and what the
 rules are for playing each kind of card out of it.
 
-> **Per-card facts live in [`rules/as-built.md`](rules/as-built.md)**, which is GENERATED from
-> `src/engine/content.ts` and checked by `test/card-reference.test.ts`, so it cannot disagree with
-> the game. Read it for every card's name, effect, placement and whether its printed effect actually
-> resolves yet. This document is how the deck WORKS; that one is what is in it.
+> **The card tables in this document are GENERATED from `src/engine/content.ts`** and checked by a
+> test, so they cannot disagree with the game. `npm run build:cards` rebuilds them; do not edit a
+> table by hand. The prose around them is how the deck WORKS; the tables are what is in it.
 >
-> **No card counts appear here, deliberately** (TODO #15a, Jesse's call 2026-08-22): counts move
-> with play balance, so a document printing them is answering a question that has a different answer
+> **Card counts are not published.** Counts move with play balance, so a printed count answers a
+> question that has a different answer
 > after the next retune. Where a count matters it is rendered as a yes/no — whether the deck deals
-> the card at all — which is a fact about the design. This page used to print a full counts table
-> and it was wrong for a month before anyone noticed.
+> the card at all — which is a fact about the design.
 
 ## The piles
 
@@ -41,7 +37,7 @@ of nothing but those has exactly one way forward, which is to play one.
 
 The opening deal is a house-rule choice made when the game is dealt. The default (`threeRandom`) is
 three cards from one shuffled deck; `threeTrackThreeOther` deals three track and three others from
-two separately shuffled piles, deliberately over the hand limit, so the first turn is spent choosing
+two separately shuffled piles, over the hand limit, so the first turn is spent choosing
 which district you can afford to build.
 
 Drawing is one of the three Local Operations options — see [Rules](rules.md)
@@ -56,16 +52,31 @@ Track cards are ordinary Home Office cards, not a separate personal supply.
   through route, or it breaks the main.
 - Placing track **on a Limit sign** extends the Running Track and moves that sign outward. The sign
   is a physical card, so it moves rather than being left stranded mid-track.
-- **Nothing may be placed outside your Limits** — track, industries and, since v0.8.0.14, Modifiers
-  too. Your district ends at its sign.
+- **Nothing may be placed outside your Limits** — track, industries and Modifiers alike. Your
+  district ends at its sign.
 - Curves and turnouts are printed left- or right-handed. A card may be turned 180° but never flipped
   over, so its 45° leg never changes diagonal.
 - A **turnout may upgrade** an existing straight, or a curve whose arc is exactly the turnout's
-  diverging arc. Not if the card holds standing cars or an enhancement. Every other occupied square
-  is unavailable.
+  diverging arc. An **industry may be built over a straight** off the Running Track, on the same
+  principle. Neither is allowed if the card holds standing cars or an Enhancement, and every other
+  occupied square is unavailable.
 - A turnout may be **run through but not stopped on**: it is not Operational Rail, so a Move may not
   end there.
 
+<!-- BEGIN CARDS: track -->
+| Track | Geometry | Hand | Operational rail | Move cost | Dealt |
+| --- | --- | --- | :---: | ---: | :---: |
+| Straight track | straight | none | yes | 1 | yes |
+| Curved track (right) | curved | right | yes | 1 | yes |
+| Curved track (left) | curved | left | yes | 1 | yes |
+| Sharp Curved Track (right) | sharpCurved | right | yes | 2 | no |
+| Sharp Curved Track (left) | sharpCurved | left | yes | 2 | no |
+| Turnout (right) | turnout | right | — | 1 | yes |
+| Turnout (left) | turnout | left | — | 1 | yes |
+
+A row marked "no" is a shape the engine understands but the deck does not currently print.
+<!-- END CARDS: track -->
+
 ## Office cards
 
 Every player begins at a **Whistle Post**, which is not drawn from the deck: one A/D track, no
@@ -78,12 +89,34 @@ passenger slot; a Depot and above is a Control Point and a Passenger Facility.
 
 An upgrade takes no placement: the Office is where it already is.
 
+<!-- BEGIN CARDS: office -->
+Upgrades are strictly sequential — no skipping a tier — so a Terminal needs all three cards in
+order. Green slots are outbound passengers, red are inbound, and the design gives slots **equal**
+to Porters rather than one more.
+
+| Office | Control point | Passenger facility | A/D tracks | Porters | Green | Red |
+| --- | :---: | :---: | ---: | ---: | ---: | ---: |
+| Whistle Post | — | — | 1 | 0 | 0 | 0 |
+| Depot | yes | yes | 2 | 1 | 1 | 1 |
+| Station | yes | yes | 3 | 2 | 2 | 2 |
+| Terminal | yes | yes | 4 | 3 | 3 | 3 |
+
+Whistle Posts are a fixed supply of 4 outside the deck, and Limits signs a
+supply of 8.
+<!-- END CARDS: office -->
+
 ## Freight facilities
 
 An industry is placed on a connected straight **stub off the Running Track** — never on the Running
 Track itself, and never outside the Limits. A Facility carries its own rails, so placing one places
 track.
 
+**It may also be built over a straight already laid**, in the same way a turnout may upgrade one, so
+rail can go down before the industry that will serve it. Only a plain straight may be built over: a
+Facility carries east–west track, so replacing a straight cannot break a neighbour's connection,
+while a curve or a turnout carries rails the Facility does not. The square must be clear of standing
+cars and carry no Enhancement — the replaced card leaves play.
+
 Each begins with one Laborer and a three-box **MEN | AT | WORK** pipeline. No Office Area may hold a
 duplicate industry, or both ends of a lockout pair — a producer and the consumer of the same
 commodity cannot be built in one district.
@@ -92,22 +125,67 @@ commodity cannot be built in one district.
 count. That distinction was a real bug: box count is how much WORK an industry can hold, not how
 much RAIL it has, and conflating the two invented a printed siding no industry card carries.
 
+<!-- BEGIN CARDS: facilities -->
+Each lists the car types it works, which way its traffic flows, and the industries it may not sit
+beside. **Every lockout pair is a producer and the consumer of the same commodity** — you may
+build one end of a chain or the other, never both, which is what forces traffic to run between
+districts rather than in circles inside one. No two of the same industry may share an Office Area,
+and that rule is enforced for every kind rather than repeated in each row.
+
+| Industry | Cars | Flow | Green | Red | Laborers | Locked out with |
+| --- | --- | --- | ---: | ---: | ---: | --- |
+| Freight House | boxcar | both | 1 | 1 | 1 | Grocer's Warehouse |
+| Mine Tipple | hopper | outbound | 1 | 0 | 1 | Power Plant |
+| Refinery | tank | outbound | 1 | 0 | 1 | Power Plant |
+| Power Plant | hopper, tank | inbound | 0 | 1 | 1 | Mine Tipple, Refinery |
+| Packing Sheds | reefer | outbound | 1 | 0 | 1 | Grocer's Warehouse |
+| Grocer's Warehouse | boxcar, reefer | inbound | 0 | 1 | 1 | Packing Sheds, Freight House |
+<!-- END CARDS: facilities -->
+
 ## Facility modifiers
 
-A Modifier sits on an empty square among the **nine spots around its host Facility** — and, since
-v0.8.0.14, **inside your Limits**, like everything else. It may not stand in the Running Track row.
-One of each kind per Office Area.
+A Modifier sits on an empty square **square against its host Facility — north, south, east or
+west**. It may not go on a diagonal: touching at a corner is not touching. It must be **inside your
+Limits**, like everything else, and may not stand in the Running Track row. One of each kind per
+Office Area.
 
 **A Modifier adds a BOX, never room for a car.** A Truck Dock beside a Grocer's Warehouse gives it a
 second red box — somewhere for one more arriving load to be cleared to — and changes nothing about
 how many cars may be spotted there.
 
+**A passenger Modifier needs a Passenger Facility.** A Waiting Area, Restaurant or Hotel may not be
+played at an Office that is still a **Whistle Post** — a Whistle Post is not a Passenger Facility, so
+there is nothing for the card to add to. Upgrade the Office to a **Depot** or better first.
+
 **A grant the host cannot use does nothing**, and the game says so rather than pretending. An
 outbound bonus beside an inbound-only facility, or the Truck Dock's inbound bonus beside the
 outbound-only Packing Sheds, is discarded — the latter leaving that card with no effect at all.
-Passenger modifiers beside a **Whistle Post** add Porters but create no outbound slot until the
-Office becomes a Passenger Facility; the panel reports that as DORMANT rather than claiming the
-facility "only receives", which was wrong in both directions.
+
+<!-- BEGIN CARDS: modifiers -->
+Each sits beside a host and raises one of its capacities. `office` as a host means any Passenger
+Facility — so a modifier that adds a green slot to an Office adds nothing to a Whistle Post, which
+is not one.
+
+| Modifier | Hosts | +Green | +Red | +Laborers | +Porters |
+| --- | --- | ---: | ---: | ---: | ---: |
+| Waiting area | any Passenger Facility | 1 | — | — | 1 |
+| Restaurant | any Passenger Facility | 1 | — | — | 1 |
+| Hotel | any Passenger Facility | 1 | — | — | 1 |
+| Truck dock | Freight House, Packing Sheds, Grocer's Warehouse | — | 1 | — | — |
+| Railroad Express Agency | Freight House | 1 | — | 1 | — |
+| Forklifts | Freight House, Packing Sheds | 1 | — | 1 | — |
+| Prep Plant | Mine Tipple | 1 | — | 1 | — |
+| Coal Piles | Mine Tipple | 1 | — | 1 | — |
+| Conveyor Belts | Mine Tipple | 1 | — | 1 | — |
+| Pipelines | Refinery | 1 | — | 1 | — |
+| Oil Depot | Refinery | 1 | — | 1 | — |
+| Viscosity breakers | Refinery | 1 | — | 1 | — |
+| Transmission lines | Power Plant | — | — | 1 | — |
+| Rotary Dumps | Power Plant | — | — | 1 | — |
+| Steam Turbines | Power Plant | — | — | 1 | — |
+| Ice House | Packing Sheds, Grocer's Warehouse | 1 | — | 1 | — |
+| Local small groceries | Grocer's Warehouse | — | — | 1 | — |
+<!-- END CARDS: modifiers -->
 
 ## Train cards
 
@@ -121,9 +199,6 @@ house rule — `divisionPointsOnly`, `ownOffice`, or `anyOffice` (the default)
 also available, because it is the one Mainline card with a yard. An Extra runs once and its card
 goes to the Salvage Yard.
 
-> The v0.4.5 behaviour of launching every Extra eastbound from the Western Division Point was
-> replaced in v0.6.2. The number no longer decides an Extra's direction; the start does.
-
 The listed consist is a **maximum, not a minimum**. A train may depart with fewer cars, but not with
 more, not of the wrong category, not with a car behind the caboose, and not with the engine buried
 among its own cars. A Crew Tray holds four pieces, and a caboose counts toward the four.
@@ -131,14 +206,48 @@ among its own cars. A Crew Tray holds four pieces, and a caboose counts toward t
 A train made up short of what its card calls for is reported as such, with what it wanted and why
 the yard could not supply it — see Rules §4.4.
 
-**Per-train consists and printed rules: [`rules/as-built.md`](rules/as-built.md) § Trains.** It
+**Per-train consists and printed rules are in the table under § Train cards below.** It
 carries the `empties only`, `reefers only`, `drop only` and `pick up empties only` restrictions,
 every one of which the engine enforces.
 
+<!-- BEGIN CARDS: trains -->
+### Timetabled
+
+| # | Class | Speed | Runs | Consist | Printed rules |
+| ---: | --- | --- | --- | --- | --- |
+| 1 | Crack Limited | fast | west | 2 coaches (2 pieces) | terminals only; no switching; expedite; *"Stop at Terminals only."* |
+| 2 | Crack Limited | fast | east | 2 coaches (2 pieces) | terminals only; no switching; expedite; *"Stop at Terminals only."* |
+| 3 | Express | fast | west | 2 freight (2 pieces) | one freight per location; expedite; *"May drop or pick up one freight car at every location."* |
+| 4 | Express | fast | east | 2 freight (2 pieces) | one freight per location; expedite; *"May drop or pick up one freight car at every location."* |
+| 5 | The Sparrow | fast | west | 3 coaches (3 pieces) | no switching; expedite |
+| 6 | The Sparrow | fast | east | 3 coaches (3 pieces) | no switching; expedite |
+| 7 | Local | slow | west | 1 freight + 1 coach (2 pieces) | coach stays on station track; *"Maximum one freight, one coach."* |
+| 8 | Local | slow | east | 1 freight + 1 coach (2 pieces) | coach stays on station track; *"Maximum one freight, one coach."* |
+| 9 | Heavy Freight | slow | west | 3 freight + 1 caboose (4 pieces) | — |
+| 10 | Heavy Freight | slow | east | 3 freight + 1 caboose (4 pieces) | — |
+| 11 | Drag Freight | slow | west | 2 freight + 1 caboose (3 pieces) | — |
+| 12 | Drag Freight | slow | east | 2 freight + 1 caboose (3 pieces) | — |
+
+### Extras
+
+| # | Class | Speed | Runs | Consist | Printed rules |
+| ---: | --- | --- | --- | --- | --- |
+| X13 | Appleseed Extra | slow | player's choice | 3 freight + 1 caboose (4 pieces), empties only | drop only; *"May drop MTs but not pick up anything."* |
+| X14 | Fruit Growers Express | fast | player's choice | 2 reefers + 1 caboose (3 pieces) | expedite; *"Reefers only. May pick up one extra loaded reefer."* |
+| X15 | Yard Xfer | slow | player's choice | 2 freight + 1 caboose (3 pieces) | — |
+| X16 | Light Engine Move | fast | player's choice | engine only | no switching; *"No cars at all."* |
+| X17 | Campaign Train | fast | player's choice | 1 coach (1 piece) | no switching; stop then expedite; stop earns point; must run loaded; *"One turn at station (speeches) then expedite. Earns a point per Office Area if the candidate is aboard."* |
+| X18 | Circus Train | slow | player's choice | 2 freight + 1 coach + 1 caboose (4 pieces) | no switching; stop earns point; must run loaded; *"One turn stopped in an Office Area (circus set-up) earns 1 point, once per Area, if fully loaded."* |
+| X19 | Military Train | slow | player's choice | 1 freight + 2 coaches (3 pieces) | no switching; no passenger work; expedite; must run loaded; *"Troops and materiel: runs loaded where the yard can supply it."* |
+| X20 | Director's private car | slow | player's choice | 2 freight + 1 coach (3 pieces) | no passenger work |
+| X21 | Freight Extra | slow | player's choice | 3 freight + 1 caboose (4 pieces) | — |
+| X22 | Pee-Dee | slow | player's choice | 1 caboose (1 piece) | pick up empties only; *"Per-diem train. May only pick up MTs."* |
+<!-- END CARDS: trains -->
+
 ## Enhancements, Mainline modifiers and Maneuvers
 
 - **Enhancements** are played into your district and change what a square does — the **Small Yard**
-  (re-order a consist for one Move), **Interlocking**, **Yard Office** and the rest. `as-built.md`
+  (re-order a consist for one Move), **Interlocking**, **Yard Office** and the rest. The table below
   marks each one `live`, `dormantSolo` or `unbuilt`, which is the part only the implementation
   knows.
   - **ABS Signals is the exception, and it matters.** It is dealt as an Enhancement but is **not
@@ -151,9 +260,139 @@ every one of which the engine enforces.
   Poling is catalogued but its effect is recorded as "TBD in the source", so there is nothing to
   implement.
 
+<!-- BEGIN CARDS: enhancements -->
+The column that only the implementation can fill in: **whether the printed effect actually
+resolves yet.** `live` is read during play; `dormantSolo` is implemented at the point of attack
+but the attack is an opponent-directed card held out of every deck, so nothing reaches it in a
+solitaire game; `unbuilt` means the effect is recorded and nothing reads it. A transcription
+cannot carry this column, which is the argument for generating the page rather than writing it.
+
+| Enhancement | Placement | Requires | Effect resolves |
+| --- | --- | --- | :---: |
+| Interlocking | runningTrackStraight | — | **live** |
+| Facing Point Locks | onCard | interlocking in the district | **dormantSolo** |
+| Yard Office | secondaryTrackStraight | — | **live** |
+| Small Yard | secondaryTrackStraight | — | **live** |
+| Water Column | runningTrackStraight | — | **dormantSolo** |
+| Overpass | onCard | — | **unbuilt** |
+| Telegraph | runningTrackStraight | — | **live** |
+| Telephone | onCard | telegraph on the same card | **live** |
+| Radio | onCard | telephone on the same card | **live** |
+| ABS Signals | mainlineCard | — | **live** |
+<!-- END CARDS: enhancements -->
+
 ## Opponent-directed cards — not dealt
 
 The **Action** and **Space-use** categories are opponent-directed and are **excluded from every
 dealt deck**, because their play rules are not implemented. They are catalogued in
-`as-built.md` so the composition is on record, and `check` refuses to play one. This is deliberate:
+the table below so the composition is on record, and `check` refuses to play one. This is deliberate:
 silently accepting them would make a card look playable while doing nothing.
+
+<!-- BEGIN CARDS: opponent -->
+**None of these is dealt in any deck today.** A card that can only be played at another player
+has no legal target in a solitaire game, and a defence with nothing to defend against is as dead
+a draw as the attack — so both halves are held out until the attacks are implemented. They are
+listed because they are the design, and because what a defence answers is the only record of why
+it exists.
+
+### Action cards — opponent-directed
+
+| Card | Played on | Effect | Answers |
+| --- | --- | --- | --- |
+| Derail | a moving train in the Local Phase | That train must stop for the remainder of the turn. | — |
+| Broken coupler | a moving train in the Mainline Phase | That train must stop and not move. | — |
+| Railroad crossing | any Secondary Track Straight | May not be used as a stop point for switching. May not become an Industry. | — |
+| Per Diem inventory | another player | Lose one point per 2 empty cars on Secondary Tracks. | — |
+| Demurrage charge | another player | Lose one point per 2 loaded freight cars on Secondary Tracks. | — |
+| Customer complaints | another player | Lose one point per 2 coaches in loading boxes. | — |
+| Vandalism | another player | A train passing a Hobo Jungle has a boxcar looted (converted to empty). | — |
+| Hotbox | another player | A train just arrived must set one car (chooser’s pick) onto Secondary Track until it departs. | — |
+| Outlawed | another player | A train just arrived may not depart for one turn — the crew’s hours have expired. | — |
+
+### Space-use cards — opponent-directed
+
+| Card | Played on | Effect | Answers |
+| --- | --- | --- | --- |
+| Bean house | adjacent to any straight, curve, turnout, Limit | Burns tablespace. | — |
+| Flop house | adjacent to any straight, curve, turnout | Burns tablespace. | — |
+| Watertower | adjacent to any straight, turnout on Running Track | Burns tablespace. | — |
+| Hobo Jungle | adjacent to any straight, turnout, Limit on Running Track | Burns tablespace. Vandalism can loot a boxcar passing it. | — |
+| Section House | adjacent to any straight, curve, turnout | Burns tablespace. | — |
+| City blocks | adjacent to any straight, curve, turnout, Limit | Burns tablespace. | — |
+| Engine Shops | adjacent to any straight, curve, turnout | Burns tablespace. | — |
+| Tenderloin District | adjacent to any straight, curve, turnout, Limit | Burns tablespace. | — |
+| Engineer cemetery | adjacent to any straight, curve, turnout, Limit | Burns tablespace. | — |
+
+### Maneuver cards
+
+| Card | Played on | Effect | Answers |
+| --- | --- | --- | --- |
+| Red Flags | any time | A stopped train is prevented from being hit; the approaching train is prevented from moving. | — |
+| Flying Switch | any time | Break a cut of cars away from behind the engine and roll them into an industry. | — |
+| Poling | any time | TBD in the source. | — |
+
+Mainline modifier cards, for completeness — these ARE dealt:
+
+| Card | Played on | Effect | Answers |
+| --- | --- | --- | --- |
+| Brakeman | a GRADE Mainline card | Faster passage downhill. | — |
+| Airbrakes | a GRADE Mainline card | Faster passage downhill. Brakeman must be in effect. | — |
+| Helpers | a GRADE Mainline card | Faster passage uphill. | — |
+| Realignment | a Mainline card | Convert one Mainline type to another. Not while a train is on it. | — |
+| Facing Point Locks | adjacent to Interlocking | Prevents Derail being played on you. | Derail |
+<!-- END CARDS: opponent -->
+
+## The Second Section card
+
+**Ordering a Second Section costs the card.** Played on a train that is **due out this Stage**, it
+sends a second, identical train out right behind the first. That second train needs a Crew Tray of
+its own, so there has to be one free.
+
+It is the one card that deliberately creates the **following-train** situation §8.1 makes the
+Superintendent rule on — so playing it is choosing to put that question to them.
+
+One copy in the deck, spent when it is played.
+
+## Trains that pay for stopping
+
+Two Extras pay for **standing still** rather than for running: the **Circus Train** (X18) and the
+**Campaign Train** (X17). Their card is worth nothing if it is run like an ordinary train.
+
+Three conditions, all of them required:
+
+- **Stopped.** The train spent a whole Mainline Phase without moving. Switching around inside a
+  district does not break it — what breaks it is leaving before a Mainline Phase passes.
+- **In an Office Area.** Any square in a player's district. Standing on the Mainline or at a
+  Division Point pays nothing. A **Whistle Post district counts** — the rule is about the area, not
+  the Office's tier.
+- **Fully loaded.** Every car except the caboose is carrying something. A train made up short, or
+  carrying an empty, earns nothing however long it stands.
+
+**One point per district**, and the point goes to whoever sits in the district it stopped in. A
+Circus touring three districts is paid three times; one parked in the same district all game is paid
+once. Neither train may switch, so it cannot load itself — it must be made up loaded before it goes.
+
+## The Office you start on
+
+Every district opens on a **Depot** unless the table chooses otherwise. A Depot has two A/D tracks
+and is a Passenger Facility, so passengers earn from the first Stage and a second train can stand at
+an Office without wrecking.
+
+**"Players start with Whistle Posts, not Depots"** is the harder game, set when the game is created.
+A Whistle Post has **one** A/D track and is not a Passenger Facility: no passenger earns anything
+until somebody draws and plays a Depot upgrade, and a second train arriving is a collision unless an
+Interlocking holds it at the Limits.
+
+The deck follows the choice. Starting on Depots, the **Depot upgrade cards are left out** — an
+upgrade must be to the next tier up, so a Depot card at a table that already has Depots is a dead
+draw. Station and Terminal are still upgrades and stay in.
+
+## What a train may pick up
+
+Coupling is mandatory, so a train forbidden to pick cars up may not make the move that would pick
+them up — there is no "move but leave them". A square the rails reach but the train's card forbids
+is shown as blocked, with the rule that forbids it.
+
+**A train may always recover its own caboose.** A caboose at the far end is what makes a train
+ready to leave, so a card that says "may drop but not pick up anything" would otherwise let a train
+strand itself for good the moment it set its caboose down.

docs/mainline-deck.md

@@ -1,22 +1,19 @@
 # Station Master — Mainline Deck
 
-**Describes the game as built at v0.8.1.0** (2026-09-22). These references are kept current with
-every release rather than versioned as editions, so there is no version in the filename: this file
-is always the latest, and the build it describes is stated here.
+**Version 0.8.2** · 2026-09-23
 
 **Scope:** the tarot-sized Mainline cards placed between Offices — how the deck is dealt, what a
 card does to a train crossing it, and the Home Deck cards played onto one.
 
-> **Per-card numbers live in [`rules/as-built.md`](rules/as-built.md)**, which is GENERATED from
-> `src/engine/content.ts` and checked by `test/card-reference.test.ts`, so it cannot disagree with
-> the game. This document explains how the deck is used; that one is the table of record. Where the
-> two ever differ, as-built is right.
+> **The card table in this document is GENERATED from `src/engine/content.ts`** and checked by a
+> test, so it cannot disagree with the game. `npm run build:cards` rebuilds it; do not edit it by
+> hand. The prose explains how the deck is used; the table is the record of what is in it.
 
 ## How Mainline cards work
 
 At setup the game lays one Mainline card between each neighbouring pair of Offices and one beyond
 each end Office, between it and a Division Point — so a game with *N* players uses **N + 1** cards.
-They are **dealt from a finite deck without replacement** (since v0.6.2), so no Division can hold
+They are **dealt from a finite deck without replacement**, so no Division can hold
 two of a card printed once. The two Division Points are the fixed ends of the Division and are not
 in the deck: `buildDivision` lays them itself.
 
@@ -27,7 +24,7 @@ A card does not belong to either neighbouring Office. It is shared Division.
 A card is divided into **regions**, and a train advances **one region per Stage**. Crossing time is
 therefore `regions − startRegion`, and nothing else. **The printed mph is scenery.**
 
-This is the part most likely to be remembered wrong, because it used to work the other way: mph set
+This is the part most likely to be remembered wrong. The printed mph does not set
 the cost and a Slow train added a Stage to *every* card. It does not. Four things move a train's
 start region and nothing else does:
 
@@ -73,23 +70,45 @@ The PDF art labels the Interchange "Yard". This reference uses **Interchange** t
 it apart from the Division Yard, the Classification Yard, the Yard Office and the Small Yard — five
 different things.
 
-**Region counts and entry points per card are in [`rules/as-built.md`](rules/as-built.md).**
+**Region counts and entry points per card are in the table under § The deck.**
+
+<!-- BEGIN CARDS: mainline -->
+| Card | Regions | Default entry | Fast / slow entry | Trains may pass | Extra may start |
+| --- | ---: | ---: | --- | :---: | :---: |
+| Plains | 1 | 0 | — | — | — |
+| Curves | 2 | 0 | — | — | — |
+| Hilly | 2 | 0 | 1 / 0 | — | — |
+| Heavy Grade | 3 | 0 | — | — | — |
+| Double Track | 1 | 0 | — | yes | — |
+| Uncontrolled Siding | 2 | 1 | — | — | — |
+| Tunnel | 2 | 0 | — | — | — |
+| Trestle | 1 | 0 | — | — | — |
+| Interchange | 2 | 1 | — | — | yes |
+
+The Mainline deck is 10 cards; the two Division Points are the fixed ends of
+the Division and are not dealt. What each card does, in the words the game uses on screen:
+
+- **Plains** — 1 region — one Stage each. · 1 Stage for every train. · One train at a time — anything following has to wait for it to clear.
+- **Curves** — 2 regions — one Stage each. · 2 Stages for every train. · One train at a time — anything following has to wait for it to clear.
+- **Hilly** — 2 regions — one Stage each. · This card reads the train's FAST/SLOW rating: a fast train starts further along and crosses in 1 Stage, a slow one in 2 Stages. No other card cares which it is. · One train at a time — anything following has to wait for it to clear.
+- **Heavy Grade** — 3 regions — one Stage each. · A grade, climbing eastward. 3 Stages to climb it and 3 Stages to run down, before help. Helpers start an UPHILL train a region further on; Brakeman does the same DOWNHILL and Airbrakes another again, and Airbrakes cannot be played without Brakeman. Never less than one Stage. · One train at a time — anything following has to wait for it to clear.
+- **Double Track** — 1 region — one Stage each. · 1 Stage for every train. · TRAINS MAY PASS — two trains may stand on this card at once, so a following train is not held behind a slower one.
+- **Uncontrolled Siding** — 2 regions — one Stage each. · A train with the card to itself starts past the back region and is across in 1 Stage. · UNCONTROLLED SIDING — arrive to find a train already here and you take the siding, a region behind it. You are not in the same place, so you do not run into it; it costs you the extra Stage instead. · One train at a time — anything following has to wait for it to clear.
+- **Tunnel** — 2 regions — one Stage each. · 2 Stages for every train. · One train at a time — anything following has to wait for it to clear.
+- **Trestle** — 1 region — one Stage each. · 1 Stage for every train. · One train at a time — anything following has to wait for it to clear.
+- **Interchange** — 2 regions — one Stage each. · A train with the card to itself starts past the back region and is across in 1 Stage. · An Extra beginning its run here starts in the back region and takes the extra Stage. · One train at a time — anything following has to wait for it to clear. · This is the one Mainline card with a yard, so an Extra Train may be made up and started here. Its printed car-sorting is NOT implemented — a consist is re-ordered at a Small Yard in a district.
+<!-- END CARDS: mainline -->
 
 ## The Interchange, and what it does NOT do
 
 The Interchange prints a car-sorting capability. **It is not implemented, and never has been.** The
 one thing the card's `sortsCars` flag actually gates is that an **Extra Train may be made up and
-started here** — it is the Mainline card with a yard, which is why §7 allows it (v0.6.2). An Extra
+started here** — it is the Mainline card with a yard, which is why §7 allows it. An Extra
 starting here begins in the back region and takes the extra Stage.
 
 Re-ordering a consist is done at a **Small Yard** in an Office Area, for one switching Move. See
 Rules §4.3.
 
-> **Corrected 2026-09-20.** Until this pass the card said "Cars may be sorted into any new order
-> here" — on the board, in the tooltip a player reads, and in the generated reference. A card
-> advertising an action the game will not offer sends a player hunting for a button that does not
-> exist. The description now says what the card does.
-
 ## Heavy Grade modifiers
 
 Home Office cards, played onto a Mainline card during a player's Draw option.
@@ -99,11 +118,17 @@ Home Office cards, played onto a Mainline card during a player's Draw option.
 | Brakeman | Heavy Grade only. A **downhill** train starts one region further on. |
 | Airbrakes | Heavy Grade only, and **Brakeman must already be on that card**. A downhill train starts one region further again. |
 | Helpers | Heavy Grade only. An **uphill** train starts one region further on. |
-| Realignment | Only onto an **unoccupied** Mainline card. Plains → Double Track, Curves → Plains, Uncontrolled Siding → Double Track, Trestle → Uncontrolled Siding. No other card may be realigned. |
+| Realignment | Only onto an **unoccupied** Mainline card, and only these four conversions: Plains → Double Track, Curves → Plains, Uncontrolled Siding → Double Track, Trestle → Uncontrolled Siding. |
 
 A Heavy Grade is 3 regions, so it is 3 Stages to climb and 3 to run down before help. Modifiers
 never reduce a crossing below one Stage.
 
+> **A Realignment can be a card with no legal target.** Only four of the nine Mainline types convert
+> at all — Plains, Curves, Uncontrolled Siding and Trestle — so a Division dealt Heavy Grade, Tunnel
+> and Double Track has nowhere to play one. A card already converted cannot be converted again, and
+> a card with a train on it is refused while the train is there. The card says which four it can
+> convert when you look at it in hand.
+
 ### ABS Signals — an Enhancement, but it lives out here
 
 **ABS Signals is dealt from the Home Office deck as an Enhancement, and it is the one Enhancement
@@ -135,9 +160,6 @@ around decides which modifiers are worth anything and which direction of traffic
 the whole game. Handing that to one of two neighbours advantages them over the other, and neither
 has a fair claim to it.
 
-**Re-opened and closed again on 2026-08-23**, when giving the choice to the Superintendent was
-considered and rejected. Jesse's call: v0.5.0's ruling stands. Rolling from the seed is
-deterministic, roughly even (51/49 east/west over 400 games), identical in solitaire and
-multiplayer, and keeps setup non-interactive — the game has no setup phase, so the question would
-have to interrupt play before the first Local Operations, in the minority of games that deal the
-card at all (20% at one player, rising to 50% at four).
+So the orientation is **rolled from the game's seed**. That is deterministic, roughly even
+(51/49 east/west), identical in solitaire and multiplayer, and keeps setup non-interactive: the game
+has no setup phase, so asking would mean interrupting play before the first Local Operations.

docs/quickstart.md

@@ -1,6 +1,8 @@
 # Station Master — Quickstart
 
-**For a tester who has never played. Describes the game as built at v0.8.1.0** (2026-09-22).
+**Version 0.8.2** · 2026-09-23
+
+For a player who has never played.
 
 Read this once before you sit down. It is about twenty minutes of reading and will save you an hour
 of confusion. The deeper references are listed at the end.
@@ -32,21 +34,26 @@ and do not wait.**
 
 ## 2. How you win
 
-The game runs a set number of **Days** — five by default. Each Day is **12 Stages**, which you can
-think of as two-hour clock periods from midnight.
+A game runs for a set number of **Days**, chosen when the game is created. Each Day is **12
+Stages**, which you can think of as two-hour clock periods from midnight.
 
-At the end of the last Day:
+At the end of the last Day, the table's **combined Revenue** is checked against a floor. **Miss it
+and everybody loses**, however well you personally did — this is the number to watch. The floor is
+worked out from the number of players and Days when the game is dealt, and whoever sets the game up
+can raise or lower it.
 
-1. **The table's combined Revenue is checked first**, against a floor of **3 × players × Days**. At
-   three players over five Days that is 45. **Miss it and everybody loses**, however well you
-   personally did. This is the number to watch.
-2. **Co-op:** meeting the floor is the win, together.
-3. **Competitive:** meeting the floor puts the game on, and the **highest individual Revenue** wins.
-4. **Solitaire:** meet the floor by yourself.
+Clear the floor, and how you win depends on the game type:
+
+- **Co-op** — clearing the floor is the win, together.
+- **Competitive** — clearing the floor puts the game on, and the **highest individual Revenue**
+  wins. Everyone is still working towards the same floor first.
+- **Cutthroat** — competitive, with the opponent-directed cards in play, so players can act against
+  each other directly. Those cards are not implemented yet, so this plays as Competitive today.
+- **Solitaire** — clear the floor by yourself.
 
 **Collisions can end it early and badly.** Breaching the collision limit stops play at once in a
-collective loss — the railroad has been declared unsafe. Default limits are 3 in one Day and 5 in
-the game.
+collective loss: the railroad has been declared unsafe. The limits are configurable, and can be
+switched off entirely.
 
 **Falling short offers another Day** rather than just ending, so a game that misses the floor can be
 played on. A game stopped by collisions cannot.
@@ -59,11 +66,11 @@ played on. A game stopped by collisions cannot.
 | A passenger getting off at your platform | 1 |
 | Completing an outbound freight load | 1 |
 | Completing an inbound freight unload | 1 |
-| A train completing its run across the whole Division | 0 by default, to every player |
+| A train completing its run across the whole Division | paid to every player; usually set to 0 |
 
-Those rates are set when the game is dealt and can be changed. The default means **your score comes
-almost entirely from working cars in your own district** — trains passing through pay nothing by
-themselves.
+Every rate is set when the game is dealt and can be changed. As they usually stand, **your score
+comes almost entirely from working cars in your own district** — trains passing through pay nothing
+by themselves.
 
 ---
 
@@ -100,7 +107,13 @@ Stage not spent switching.
 
 ## 4. The screen
 
-Left column, top to bottom:
+**Across the top:** your Revenue, the target, the Day and Stage, collisions, and the game code.
+
+**When other players are acting**, their turns are replayed on your board a step at a time rather
+than arriving already rearranged, with a `[N behind]` counter, **Pause** and **Skip**. Your own moves
+are not replayed at you — they are already on your screen.
+
+**The main display, on the left**, top to bottom:
 
 - **The Division — west to east.** The shared main line: every Office and the Mainline cards between
   them, with trains drawn where they are. **West is always on the left**, and a train's engine is
@@ -109,7 +122,7 @@ Left column, top to bottom:
   outside the phases that change it, unless you pin it open.
 - **History.** What has happened, most recent first.
 
-Right column:
+**The right-hand column:**
 
 - **Your Move** — the buttons. If it is not your turn this is empty, and the board tells you who is
   acting.
@@ -121,23 +134,20 @@ Right column:
 - **Blocked — why nothing is moving.** *Read this panel.* When something will not work, this is
   where the game explains why, in rules terms.
 - **Facilities** — the load pipelines at each industry.
-
-Across the top: your Revenue, the target, the Day and Stage, collisions, and the game code.
-
-**When other players are acting**, their turns are replayed on your board a step at a time rather
-than arriving already rearranged, with a `[N behind]` counter, **Pause** and **Skip**. Your own moves
-are not replayed at you — they are already on your screen.
+- **This Game** — the seed or your seat, the game code, the rules this game was dealt under, and
+  links to this guide and the other references.
 
 ---
 
-## 5. Your first twenty minutes
+## 5. Start with solitaire
 
 Play a **solitaire** game first. It needs no server and nobody else, and it is the same rules.
 
 1. Open the site, choose **Play solitaire**, accept the defaults, **Deal**.
-2. **Stage 1 — Draw.** You start on a **Whistle Post** with almost nothing. Play a track card or two
-   to extend your Running Track, and get a **Depot** down as soon as one appears: it is the upgrade
-   that makes you a passenger facility and gives you a second A/D track.
+2. **Stage 1 — Draw.** You start on a **Depot** with almost nothing else. Play a track card or two to
+   extend your Running Track. A Depot already works passengers and has two A/D tracks, so a second
+   train can stand at your Office without wrecking; a **Station** upgrade, when one appears, buys a
+   third track and another Porter.
 3. **Build one industry** on a stub off the main — not on the Running Track itself, which the game
    will not allow.
 4. **Play a train card** when you get one. It rolls onto the timetable and then runs at that Stage
@@ -147,8 +157,6 @@ Play a **solitaire** game first. It needs no server and nobody else, and it is t
 6. Watch the **Blocked** panel whenever you are stuck. It is usually one missing thing: no empty car
    spotted, no loaded car in the yard, a full box, a locked industry track.
 
-Then play a Day or two of multiplayer with bots filling the other seats, to see the table take turns.
-
 ---
 
 ## 6. Things that surprise new players
@@ -167,33 +175,37 @@ Then play a Day or two of multiplayer with bots filling the other seats, to see
 - **Passengers may dry up completely.** Coaches move one way — boarding sends the emptied coach to
   the Classification Yard, and it only comes back when the Division Yard is bare, which may never
   happen. When it does, the yard panel warns you and passenger trains are made up empty. **This is
-  the rules working as designed**, not a bug; report how it felt, not that it happened.
+  the rules working as designed.**
 - **Expedited trains leave the same Stage they arrived**, after the Cargo phase. Ordinary ones wait.
 
----
-
-## 7. What to report
-
-Most useful, in order:
-
-1. **What you expected versus what happened**, with the Day and Stage. "Day 2 Stage 9, train 5 had
-   no coaches" is worth more than "passengers seem broken".
-2. **Save the game** (the **Save replay** button) and send the file. A save is the seed and the moves
-   made, so it replays exactly and the bug can be looked at directly.
-3. **Anything the screen did not explain.** If you had to guess a rule, that is a finding even when
-   the game was right.
-4. **Anything you went looking for and could not find.**
-
-Bugs go to the tracker; anything unclear in this guide is also worth saying.
+After playing some solitaire, play a day or two of multiplayer with bots or friends to get a feel
+for how players interact. Then you are ready to run a real division.
 
 ---
 
-## 8. Where to read more
+## 7. Issues / Suggestions
+
+Please do report anything that looks like a bug or an area to be improved.
+
+- **What you expected versus what happened**, with the Day and Stage. "Day 2 Stage 9, train 5 had
+  no coaches" is worth more than "passengers seem broken".
+- **Save the game** (the **Save replay** button) and send the file. A save is the seed and the moves
+  made, so it replays exactly and the problem can be looked at directly.
+- **Anything the screen did not explain.** If you had to guess a rule, that is worth saying even
+  when the game was right.
+- **Anything you went looking for and could not find.**
+
+**A save replays under the rules of the build that opens it.** When a rule changes, a save made
+before it may stop part-way — the game says which move it stopped on and leaves your file untouched,
+so the build you played on will still finish it.
+
+---
+
+## 8. Documentation / References
 
 | For | Read |
 | --- | --- |
 | The rules in full, with the FAQ | [Rules](rules.md) |
-| Every card, generated from the code | [`rules/as-built.md`](rules/as-built.md) |
 | How the Home Office deck is dealt and played | [Home deck](home-deck.md) |
 | The Mainline cards and what they do to a train | [Mainline deck](mainline-deck.md) |
 | Rolling stock, yards, trays, the Fedora | [Components](components.md) |

docs/rules.md

@@ -1,12 +1,10 @@
 # Station Master — Rules
 
-**Describes the game as built at v0.8.1.0** (2026-09-22). These references are kept current with
-every release rather than versioned as editions, so there is no version in the filename: this file
-is always the latest, and the build it describes is stated here.
+**Version 0.8.2** · 2026-09-23
 
 **Authority:** observed code paths and tests. Where a card face, a prototype document and executable
 behaviour differ, this document reports **executable behaviour** and marks unimplemented material.
-Per-card numbers are not repeated here — [`rules/as-built.md`](rules/as-built.md) is generated from
+Per-card numbers are not repeated here — the Home deck and Mainline deck references carry tables generated from
 `src/engine/content.ts` and is the table of record.
 
 **New to the game? Start with the [Quickstart](quickstart.md).**
@@ -30,7 +28,7 @@ This book is divided as follows:
 The companion references are the [Quickstart](quickstart.md) for a new player,
 [Mainline deck](mainline-deck.md), [Home deck](home-deck.md),
 [components](components.md), and the generated per-card table
-[`rules/as-built.md`](rules/as-built.md).
+[Home deck](home-deck.md) and [Mainline deck](mainline-deck.md).
 
 ## 2. Definitions
 
@@ -119,9 +117,7 @@ The browser also stores the current local game and resumes it automatically when
 
 Three modes: **Solitaire**, **Competitive** and **Co-op**. All three are playable.
 
-**Length is a free `days` count**, not a preset. The old `short`/`standard`/`campaign` presets
-carried a `target` and were dropped in 2026-08; they survive only as a convenience argument for the
-simulation tooling, resolving to 3, 5 and 10 Days. The default is 5.
+**Length is a free `days` count**, not a preset — any number of Days may be set. The default is 5.
 
 **How a game ends and who wins:**
 
@@ -196,7 +192,7 @@ On a player’s Local Operations turn, choose exactly one available option.
 
 **Switch.** Select any Crew Tray currently in that player’s Office Area. It gets six Moves, or five under Reduced Visibility on the listed night Stages. A Move travels any connected distance in one direction and must end on Operational Rail. Reversing is a separate Move. A train may pass through a turnout but cannot stop on it. It may not share or pass through another train except through an Office with a free A/D track.
 
-Standing cars couple automatically when the train reaches them; it may not pass them, and the resulting consist may not exceed four cars. Coupling forward places cars ahead of the engine; coupling while backing places them behind it. Setting out cars does not spend a Move, but the cut must come from an outer end of the consist and may not be left on the Office. A **Small Yard** re-orders a consist for one Move, and since v0.8.0.14 may also place cars **ahead
+Standing cars couple automatically when the train reaches them; it may not pass them, and the resulting consist may not exceed four cars. Coupling forward places cars ahead of the engine; coupling while backing places them behind it. Setting out cars does not spend a Move, but the cut must come from an outer end of the consist and may not be left on the Office. A **Small Yard** re-orders a consist for one Move, and may also place cars **ahead
 of the engine** — which is how a cut is set up to be shoved into a facing industry. Each option on
 the menu shows the train it would build, laid out west to east as the board draws it, and says
 whether the result may leave the Office or would be held there. Flying Switch spends one Move to
@@ -211,18 +207,14 @@ roll a tail cut into a connected Freight Facility.
 > draw actually empties the pile; a pile with cards buried under the one taken is not refilled, or
 > the Departments would grow without limit and drain the deck into themselves.
 >
-> This surprised a player at the table (2026-09-22), which is why it is written down here: the rule
-> was implemented from the prototype rules and had never reached this document.
-
 **Freight Agent.** Make one of these operations, then the turn ends: stock one green outbound box from a matching loaded Division Yard car; clear one red inbound box to the Classification Yard; unjam one outbound, inbound, or MEN | AT | WORK load to the Classification Yard; or explicitly end without acting. Freight can be stocked only when an unclaimed empty matching car is already spotted at that industry. Passengers may wait in a green Office box without a train present.
 
 > **A car cleared from a red Inbound box comes back empty.** Whatever was in it has arrived — the
 > passengers are out of the station, or the load is in the industry — and the Revenue for it was
 > paid on arrival, not on clearing. What returns to the Classification Yard is the *car*, in the
-> common supply and carrying nothing. Before v0.8.1.0 it returned still marked loaded, which put
-> coaches into the yards that could never be used to unload another passenger.
+> common supply and carrying nothing.
 
-Implementation note, still true at v0.8.1.0: `card.discard` is accepted during Local Operations
+Implementation note: `card.discard` is accepted during Local Operations
 without checking that the Draw option was chosen — unlike `card.play`, which does check. This is an
 implementation quirk rather than a fourth published turn option.
 
@@ -294,10 +286,9 @@ Car permit no passenger work. A Whistle Post has no Porters.
 > could board or detrain anywhere for the rest of the game, while trains whose cards call for coaches
 > were made up empty.
 >
-> **This is the rules working as printed and the ruling is that it stands** (Jesse, 2026-09-17, the
-> same ruling Gitea#2 got: running out is part of the game). What changed is that the game now says
-> it — the yard panel warns while the shortage lasts, and a train made up short reports why. Whether
-> the ratchet should be broken is open as TODO #108, to be decided on a second game's evidence.
+> **This is the rules working as printed: running out of cars is part of the game.** The yard panel
+> warns while the shortage lasts, and a train made up short reports what it wanted and why none is
+> coming.
 
 ### 4.7 Freight work
 
@@ -334,7 +325,7 @@ score has to come principally from passenger and freight work.
 
 ### 6.1 What the engine supports
 
-The rules engine has always supported multiple named players; since v0.7 the lobby, server and
+The rules engine supports multiple named players; the lobby, server and
 client around it are delivered too, so this section now describes a game people actually play. The
 engine has player, seat, score, Office Area, Division, phase-order, co-op and competitive-mode data
 for multiple named players. It deals each player a hand, creates one Office Area per seat, starts acting order at the Superintendent and proceeds eastward, and models the following multiplayer-specific outcomes:
@@ -423,16 +414,15 @@ train is still present for that Stage's Load/Unload phase.
 ### Can I choose the direction of an Extra or a Heavy Grade?
 
 **An Extra, yes** — the player who played the card chooses where it starts and which way it runs, and
-loads it as they choose (v0.6.2). **A Heavy Grade, no**: orientation is rolled from the seed. That is
+loads it as they choose. **A Heavy Grade, no**: orientation is rolled from the seed. That is
 a decision rather than a gap — the card sits between two districts and belongs to neither, so handing
 the choice to one neighbour would advantage them permanently. See the Mainline deck reference.
 
 ### Can I use an Interchange to reorder a train?
 
-**No, and the card used to claim otherwise.** Its printed car-sorting has never been implemented; the
-description was corrected on 2026-09-20 to stop advertising it. What the Interchange actually offers
-is the one Mainline card with a yard, so an **Extra may be made up and started there**. Re-ordering a
-consist is done at a **Small Yard** in a district.
+**No.** Its printed car-sorting is not implemented. What the Interchange offers is the one Mainline
+card with a yard, so an **Extra may be made up and started there**. Re-ordering a consist is done at
+a **Small Yard** in a district.
 
 ### Can I play attack cards on another player?
 
@@ -442,8 +432,8 @@ is rejected.
 ### Is multiplayer playable?
 
 **Yes.** Lobby, game codes, seating, bots, an authoritative server that survives restarts, per-seat
-reconnection and a replayed view of everyone else's turns are all delivered — see §3.5 and §6. The
-opponent-directed cards remain unimplemented in every mode, so there are still no card attacks.
+reconnection and a replayed view of everyone else's turns — see §3.5 and §6. The opponent-directed
+cards are unimplemented in every mode, so there are no card attacks.
 
 ### Why did my passenger train arrive with no coaches?
 
@@ -456,3 +446,28 @@ has happened, and a train made up short says so in the log.
 Because that train is **already made up**, so every re-order on offer would break it — most often by
 moving the caboose off the rear, which §8.2 will not let a train depart with. If the train is *not*
 currently fit to run, at least one option will be marked "MADE UP, ready to leave".
+
+### Will an old save still replay?
+
+Not always. A save is a seed and the list of moves, replayed through the rules of whatever build
+opens it — so a change that makes a once-legal move illegal stops the replay at that move. The game
+names the move and leaves the file untouched; the build the game was played on will still finish it.
+
+## §8.1 in practice — what holds a train at the end of the line
+
+A train is held, released or put to the Superintendent by what is in the **Subdivision** ahead of
+it: the run of Mainline cards between two Control Points. Every Office that is not a Control Point
+lies inside one, so a table of Whistle Posts is a single Subdivision from end to end.
+
+- A train coming **towards** it is an absolute bar. The train holds, and the history says which
+  train is coming and that there is no Control Point between them to pass at.
+- A train going the **same way** is the Superintendent's ruling.
+- A card printing **"trains may pass"** excuses only what is standing on **that card**. It does not
+  clear the rest of the Subdivision.
+- A train **standing at an Office with no free A/D track** occupies the Subdivision too: it is about
+  to re-enter and there is nowhere for the two to pass. An Office with a track still free does not
+  hold anyone up.
+
+**An Office never holds more trains than it has A/D tracks.** A train the Interlocking is holding at
+the Limits takes the first track to free, ahead of anything arriving afterwards — and the train that
+arrives to find it taken is held at its own Limits, or collides if there is no Interlocking.

docs/rules/as-built.md

@@ -1,260 +0,0 @@
-# Station Master — the cards as built
-
-> **Generated from `src/engine/content.ts` by `scripts/build-card-reference.ts`. Do not edit by
-> hand** — `npm run build:cards` rewrites it, and `test/card-reference.test.ts` fails if this file
-> and the code disagree.
-
-This is the one file in `docs/rules/` that describes the game **as it currently is**. Everything
-else in this directory is a historical record and marked as such: [`rules-v0.1.md`](rules-v0.1.md)
-transcribes the prototype PDFs, [`open-questions.md`](open-questions.md) tracks how the gaps in
-them were decided, and [`rules-v0.2.md`](rules-v0.2.md) and
-[`card-reference.md`](card-reference.md) both describe superseded card sets. Read those for the
-reasoning; read this for the numbers.
-
-The engine instantiates from the same constants this is emitted from, so a disagreement between
-this page and the game is a bug in the generator, not a stale table.
-
-**No card counts appear here, deliberately** (TODO #15a, Jesse 2026-08-22): the counts move with
-play balance, so a document that prints them is answering a question that will have a different
-answer next retune. Where a count matters it is a yes/no — whether the deck deals the card at
-all — which is a fact about the design rather than about the current tuning.
-
----
-
-## Trains
-
-12 timetabled and 10 Extras, 22 in all.
-Odd numbers run west, even run east; a pair shares a class and is the same card face in two
-directions. A Crew Tray holds four pieces and a caboose counts toward the four, which is why no
-train with a caboose carries more than three revenue cars.
-
-### Timetabled
-
-| # | Class | Speed | Runs | Consist | Printed rules |
-| ---: | --- | --- | --- | --- | --- |
-| 1 | Crack Limited | fast | west | 2 coaches (2 pieces) | terminals only; no switching; expedite; *"Stop at Terminals only."* |
-| 2 | Crack Limited | fast | east | 2 coaches (2 pieces) | terminals only; no switching; expedite; *"Stop at Terminals only."* |
-| 3 | Express | fast | west | 2 freight (2 pieces) | one freight per location; expedite; *"May drop or pick up one freight car at every location."* |
-| 4 | Express | fast | east | 2 freight (2 pieces) | one freight per location; expedite; *"May drop or pick up one freight car at every location."* |
-| 5 | The Sparrow | fast | west | 3 coaches (3 pieces) | no switching; expedite |
-| 6 | The Sparrow | fast | east | 3 coaches (3 pieces) | no switching; expedite |
-| 7 | Local | slow | west | 1 freight + 1 coach (2 pieces) | coach stays on station track; *"Maximum one freight, one coach."* |
-| 8 | Local | slow | east | 1 freight + 1 coach (2 pieces) | coach stays on station track; *"Maximum one freight, one coach."* |
-| 9 | Heavy Freight | slow | west | 3 freight + 1 caboose (4 pieces) | — |
-| 10 | Heavy Freight | slow | east | 3 freight + 1 caboose (4 pieces) | — |
-| 11 | Drag Freight | slow | west | 2 freight + 1 caboose (3 pieces) | — |
-| 12 | Drag Freight | slow | east | 2 freight + 1 caboose (3 pieces) | — |
-
-### Extras
-
-| # | Class | Speed | Runs | Consist | Printed rules |
-| ---: | --- | --- | --- | --- | --- |
-| X13 | Appleseed Extra | slow | player's choice | 3 freight + 1 caboose (4 pieces), empties only | drop only; *"May drop MTs but not pick up anything."* |
-| X14 | Fruit Growers Express | fast | player's choice | 2 reefers + 1 caboose (3 pieces) | expedite; *"Reefers only. May pick up one extra loaded reefer."* |
-| X15 | Yard Xfer | slow | player's choice | 2 freight + 1 caboose (3 pieces) | — |
-| X16 | Light Engine Move | fast | player's choice | engine only | no switching; *"No cars at all."* |
-| X17 | Campaign Train | fast | player's choice | 1 coach (1 piece) | no switching; stop then expedite; stop earns point; must run loaded; *"One turn at station (speeches) then expedite. Earns a point per Office Area if the candidate is aboard."* |
-| X18 | Circus Train | slow | player's choice | 2 freight + 1 coach + 1 caboose (4 pieces) | no switching; stop earns point; must run loaded; *"One turn stopped in an Office Area (circus set-up) earns 1 point, once per Area, if fully loaded."* |
-| X19 | Military Train | slow | player's choice | 1 freight + 2 coaches (3 pieces) | no switching; no passenger work; expedite; must run loaded; *"Troops and materiel: runs loaded where the yard can supply it."* |
-| X20 | Director's private car | slow | player's choice | 2 freight + 1 coach (3 pieces) | no passenger work |
-| X21 | Freight Extra | slow | player's choice | 3 freight + 1 caboose (4 pieces) | — |
-| X22 | Pee-Dee | slow | player's choice | 1 caboose (1 piece) | pick up empties only; *"Per-diem train. May only pick up MTs."* |
-
----
-
-## Mainline cards
-
-A card is divided into **regions**, and a train advances one region per Stage — so the regions a
-card prints are what it costs to cross. Where a train *enters* is what the rules move: a fast
-train on Hilly, a Heavy Grade with Helpers, or a card whose back region is a siding rather than
-part of the road all change the entry point rather than the card's length.
-
-| Card | Regions | Default entry | Fast / slow entry | Trains may pass | Extra may start |
-| --- | ---: | ---: | --- | :---: | :---: |
-| Plains | 1 | 0 | — | — | — |
-| Curves | 2 | 0 | — | — | — |
-| Hilly | 2 | 0 | 1 / 0 | — | — |
-| Heavy Grade | 3 | 0 | — | — | — |
-| Double Track | 1 | 0 | — | yes | — |
-| Uncontrolled Siding | 2 | 1 | — | — | — |
-| Tunnel | 2 | 0 | — | — | — |
-| Trestle | 1 | 0 | — | — | — |
-| Interchange | 2 | 1 | — | — | yes |
-
-The Mainline deck is 10 cards; the two Division Points are the fixed ends of
-the Division and are not dealt. What each card does, in the words the game uses on screen:
-
-- **Plains** — 1 region — one Stage each. · 1 Stage for every train. · One train at a time — anything following has to wait for it to clear.
-- **Curves** — 2 regions — one Stage each. · 2 Stages for every train. · One train at a time — anything following has to wait for it to clear.
-- **Hilly** — 2 regions — one Stage each. · This card reads the train's FAST/SLOW rating: a fast train starts further along and crosses in 1 Stage, a slow one in 2 Stages. No other card cares which it is. · One train at a time — anything following has to wait for it to clear.
-- **Heavy Grade** — 3 regions — one Stage each. · A grade, climbing eastward. 3 Stages to climb it and 3 Stages to run down, before help. Helpers start an UPHILL train a region further on; Brakeman does the same DOWNHILL and Airbrakes another again, and Airbrakes cannot be played without Brakeman. Never less than one Stage. · One train at a time — anything following has to wait for it to clear.
-- **Double Track** — 1 region — one Stage each. · 1 Stage for every train. · TRAINS MAY PASS — two trains may stand on this card at once, so a following train is not held behind a slower one.
-- **Uncontrolled Siding** — 2 regions — one Stage each. · A train with the card to itself starts past the back region and is across in 1 Stage. · UNCONTROLLED SIDING — arrive to find a train already here and you take the siding, a region behind it. You are not in the same place, so you do not run into it; it costs you the extra Stage instead. · One train at a time — anything following has to wait for it to clear.
-- **Tunnel** — 2 regions — one Stage each. · 2 Stages for every train. · One train at a time — anything following has to wait for it to clear.
-- **Trestle** — 1 region — one Stage each. · 1 Stage for every train. · One train at a time — anything following has to wait for it to clear.
-- **Interchange** — 2 regions — one Stage each. · A train with the card to itself starts past the back region and is across in 1 Stage. · An Extra beginning its run here starts in the back region and takes the extra Stage. · One train at a time — anything following has to wait for it to clear. · This is the one Mainline card with a yard, so an Extra Train may be made up and started here. Its printed car-sorting is NOT implemented — a consist is re-ordered at a Small Yard in a district.
-
----
-
-## Office cards
-
-Upgrades are strictly sequential — no skipping a tier — so a Terminal needs all three cards in
-order. Green slots are outbound passengers, red are inbound, and the design gives slots **equal**
-to Porters rather than one more.
-
-| Office | Control point | Passenger facility | A/D tracks | Porters | Green | Red |
-| --- | :---: | :---: | ---: | ---: | ---: | ---: |
-| Whistle Post | — | — | 1 | 0 | 0 | 0 |
-| Depot | yes | yes | 2 | 1 | 1 | 1 |
-| Station | yes | yes | 3 | 2 | 2 | 2 |
-| Terminal | yes | yes | 4 | 3 | 3 | 3 |
-
-Whistle Posts are a fixed supply of 4 outside the deck, and Limits signs a
-supply of 8.
-
----
-
-## Freight facilities
-
-Each lists the car types it works, which way its traffic flows, and the industries it may not sit
-beside. **Every lockout pair is a producer and the consumer of the same commodity** — you may
-build one end of a chain or the other, never both, which is what forces traffic to run between
-districts rather than in circles inside one. No two of the same industry may share an Office Area,
-and that rule is enforced for every kind rather than repeated in each row.
-
-| Industry | Cars | Flow | Green | Red | Laborers | Locked out with |
-| --- | --- | --- | ---: | ---: | ---: | --- |
-| Freight House | boxcar | both | 1 | 1 | 1 | Grocer's Warehouse |
-| Mine Tipple | hopper | outbound | 1 | 0 | 1 | Power Plant |
-| Refinery | tank | outbound | 1 | 0 | 1 | Power Plant |
-| Power Plant | hopper, tank | inbound | 0 | 1 | 1 | Mine Tipple, Refinery |
-| Packing Sheds | reefer | outbound | 1 | 0 | 1 | Grocer's Warehouse |
-| Grocer's Warehouse | boxcar, reefer | inbound | 0 | 1 | 1 | Packing Sheds, Freight House |
-
----
-
-## Modifier cards
-
-Each sits beside a host and raises one of its capacities. `office` as a host means any Passenger
-Facility — so a modifier that adds a green slot to an Office adds nothing to a Whistle Post, which
-is not one.
-
-| Modifier | Hosts | +Green | +Red | +Laborers | +Porters |
-| --- | --- | ---: | ---: | ---: | ---: |
-| Waiting area | any Passenger Facility | 1 | — | — | 1 |
-| Restaurant | any Passenger Facility | 1 | — | — | 1 |
-| Hotel | any Passenger Facility | 1 | — | — | 1 |
-| Truck dock | Freight House, Packing Sheds, Grocer's Warehouse | — | 1 | — | — |
-| Railroad Express Agency | Freight House | 1 | — | 1 | — |
-| Forklifts | Freight House, Packing Sheds | 1 | — | 1 | — |
-| Prep Plant | Mine Tipple | 1 | — | 1 | — |
-| Coal Piles | Mine Tipple | 1 | — | 1 | — |
-| Conveyor Belts | Mine Tipple | 1 | — | 1 | — |
-| Pipelines | Refinery | 1 | — | 1 | — |
-| Oil Depot | Refinery | 1 | — | 1 | — |
-| Viscosity breakers | Refinery | 1 | — | 1 | — |
-| Transmission lines | Power Plant | — | — | 1 | — |
-| Rotary Dumps | Power Plant | — | — | 1 | — |
-| Steam Turbines | Power Plant | — | — | 1 | — |
-| Ice House | Packing Sheds, Grocer's Warehouse | 1 | — | 1 | — |
-| Local small groceries | Grocer's Warehouse | — | — | 1 | — |
-
----
-
-## Track cards
-
-Track is **in the Home Office deck** and is drawn and played like any other card — not a separate
-per-player supply. Operational Rail is the flag that says a train may stop on the card; a turnout
-may be run through but not stopped on.
-
-| Track | Geometry | Hand | Operational rail | Move cost | Dealt |
-| --- | --- | --- | :---: | ---: | :---: |
-| Straight track | straight | none | yes | 1 | yes |
-| Curved track (right) | curved | right | yes | 1 | yes |
-| Curved track (left) | curved | left | yes | 1 | yes |
-| Sharp Curved Track (right) | sharpCurved | right | yes | 2 | no |
-| Sharp Curved Track (left) | sharpCurved | left | yes | 2 | no |
-| Turnout (right) | turnout | right | — | 1 | yes |
-| Turnout (left) | turnout | left | — | 1 | yes |
-
-A row marked "no" is a shape the engine understands but the deck does not currently print.
-
----
-
-## Enhancements
-
-The column that only the implementation can fill in: **whether the printed effect actually
-resolves yet.** `live` is read during play; `dormantSolo` is implemented at the point of attack
-but the attack is an opponent-directed card held out of every deck, so nothing reaches it in a
-solitaire game; `unbuilt` means the effect is recorded and nothing reads it. A transcription
-cannot carry this column, which is the argument for generating the page rather than writing it.
-
-| Enhancement | Placement | Requires | Effect resolves |
-| --- | --- | --- | :---: |
-| Interlocking | runningTrackStraight | — | **live** |
-| Facing Point Locks | onCard | interlocking in the district | **dormantSolo** |
-| Yard Office | secondaryTrackStraight | — | **live** |
-| Small Yard | secondaryTrackStraight | — | **live** |
-| Water Column | runningTrackStraight | — | **dormantSolo** |
-| Overpass | onCard | — | **unbuilt** |
-| Telegraph | runningTrackStraight | — | **live** |
-| Telephone | onCard | telegraph on the same card | **live** |
-| Radio | onCard | telephone on the same card | **live** |
-| ABS Signals | mainlineCard | — | **live** |
-
----
-
-## Opponent-directed cards, and what answers them
-
-**None of these is dealt in any deck today.** A card that can only be played at another player
-has no legal target in a solitaire game, and a defence with nothing to defend against is as dead
-a draw as the attack — so both halves are held out until the attacks are implemented. They are
-listed because they are the design, and because what a defence answers is the only record of why
-it exists.
-
-### Action cards — opponent-directed
-
-| Card | Played on | Effect | Answers |
-| --- | --- | --- | --- |
-| Derail | a moving train in the Local Phase | That train must stop for the remainder of the turn. | — |
-| Broken coupler | a moving train in the Mainline Phase | That train must stop and not move. | — |
-| Railroad crossing | any Secondary Track Straight | May not be used as a stop point for switching. May not become an Industry. | — |
-| Per Diem inventory | another player | Lose one point per 2 empty cars on Secondary Tracks. | — |
-| Demurrage charge | another player | Lose one point per 2 loaded freight cars on Secondary Tracks. | — |
-| Customer complaints | another player | Lose one point per 2 coaches in loading boxes. | — |
-| Vandalism | another player | A train passing a Hobo Jungle has a boxcar looted (converted to empty). | — |
-| Hotbox | another player | A train just arrived must set one car (chooser’s pick) onto Secondary Track until it departs. | — |
-| Outlawed | another player | A train just arrived may not depart for one turn — the crew’s hours have expired. | — |
-
-### Space-use cards — opponent-directed
-
-| Card | Played on | Effect | Answers |
-| --- | --- | --- | --- |
-| Bean house | adjacent to any straight, curve, turnout, Limit | Burns tablespace. | — |
-| Flop house | adjacent to any straight, curve, turnout | Burns tablespace. | — |
-| Watertower | adjacent to any straight, turnout on Running Track | Burns tablespace. | — |
-| Hobo Jungle | adjacent to any straight, turnout, Limit on Running Track | Burns tablespace. Vandalism can loot a boxcar passing it. | — |
-| Section House | adjacent to any straight, curve, turnout | Burns tablespace. | — |
-| City blocks | adjacent to any straight, curve, turnout, Limit | Burns tablespace. | — |
-| Engine Shops | adjacent to any straight, curve, turnout | Burns tablespace. | — |
-| Tenderloin District | adjacent to any straight, curve, turnout, Limit | Burns tablespace. | — |
-| Engineer cemetery | adjacent to any straight, curve, turnout, Limit | Burns tablespace. | — |
-
-### Maneuver cards
-
-| Card | Played on | Effect | Answers |
-| --- | --- | --- | --- |
-| Red Flags | any time | A stopped train is prevented from being hit; the approaching train is prevented from moving. | — |
-| Flying Switch | any time | Break a cut of cars away from behind the engine and roll them into an industry. | — |
-| Poling | any time | TBD in the source. | — |
-
-Mainline modifier cards, for completeness — these ARE dealt:
-
-| Card | Played on | Effect | Answers |
-| --- | --- | --- | --- |
-| Brakeman | a GRADE Mainline card | Faster passage downhill. | — |
-| Airbrakes | a GRADE Mainline card | Faster passage downhill. Brakeman must be in effect. | — |
-| Helpers | a GRADE Mainline card | Faster passage uphill. | — |
-| Realignment | a Mainline card | Convert one Mainline type to another. Not while a train is on it. | — |
-| Facing Point Locks | adjacent to Interlocking | Prevents Derail being played on you. | Derail |
-