[Sagyam]

Thank-you letters from the roadmap's Residents idea. Families leaving neglected homes is still on the roadmap.

Who writes, and when

Each finished home (cottage or apartment) has a family. A house called "The Hart house" is the Harts. Other homes get a surname from the new names/families.txt, by lot index. The file is append-only, so a family never changes.

Letters are folded from the ledger like everything else:

Event	Writer
Street upgraded	A family on that street, else one of the 3 nearest
Building whole again (bought, kit, or session repairs)	Its own family, else one of the nearest
Park decoration	One of the nearest families
Public building opens (water, power, school, clinic, …)	One of the nearest families
Set finished	A family on the street, else one of the nearest

They pay nothing, and reading is never rewarded (the one rule). The wording lives in letters.rs. Public buildings are named as nouns ("the new school"), and later levels' water and power get a second wording.

App

• An envelope in the menu, with a brand-coloured dot for unread letters. What was read is a per-window note in localStorage, like the theme. A first run starts with nothing unread rather than a backlog.
• The Letters panel lists letters newest first, each signed by the family and their address, with "See it" opening the building's deed.
• A story line, "A letter from the … family", when one arrives while the app is open.
• The mock writes simpler letters for the same events.

Checks

• cargo test (140 in the daemon, incl. families_write_to_thank_the_mayor and the letters unit tests), cargo clippy --all-targets and cargo fmt are clean.
• bun test (47) and tsc pass.
• Printed the letters a 20-day ledger folds to check the wording; screenshot of the panel on ?mock=city.
• Not run on the real daemon; there's a host check for it in the roadmap.

🤖 Generated with Claude Code