Terminal Changelog
Add user-facing changelog entries as terminal documents in data/worlds/mansion.rec .
Workflow
Find the latest terminal document with a commit reference
grep -n "update as of" data/worlds/mansion.rec
Extract the commit hash from the most recent entry.
Fetch origin/master and get commits since that reference
git fetch origin master git log <commit>..origin/master --oneline --reverse
Analyze feature commits - Skip dependabot/CI bumps. For significant commits:
git show <hash> --stat --format="%B" | head -50
Write the terminal document following the format below
Validate
just entities
Terminal Document Format
Id: terminal_inbox_<topic> Name: INBOX - <Subject Line> Prototype: terminal_document Room: office Container: office_terminal DescriptionLong: ```
- FROM: frizzle@mudd.local
- TO: team@mudd.local
- SUBJECT: <Subject Line>
- DATE: <YYYY-MM-DD>
-
- (update as of <full-commit-hash>)
- <Body content - each line starts with "+ ">
- -Frizzle
-
Insert after the previous terminal_inbox entry, before # Gallery entities .
Content Guidelines
Focus on user-facing changes:
-
New commands (/pay , /use , etc.)
-
New items players can find or interact with
-
New locations or entities
-
Changes to game mechanics
Include gameplay tips:
-
Where to find new things ("Check the lounge for the slot machine")
-
How to use new features ("Use /pay to send money to nearby players")
-
Fun interactions ("Pull the handle to win prizes!")
Tone: Casual dev update from Frizzle. Excited about new features, hints at what's coming.
Skip: Internal refactors, CI updates, dependency bumps, bug fixes unless player-visible.