silver-tongue 0.1.1 → 0.3.0

package/README.md

@@ -2,25 +2,27 @@
 
 > You arrive speaking pidgin; you leave with a silver tongue.
 
-A language-learning life game. You arrive in a new city knowing a few words and earn your living by understanding people. Every job, purchase and conversation happens in the language you're learning.
+A language-learning life game. Your phone is dead, your wallet is gone, and you're standing on a street in a Chinese city with ¥20 in your pocket. An old man on a bench teaches you your first words; after that you earn your living by understanding people. Every job, purchase and conversation happens in the language you're learning.
 
 The first course is Mandarin (HSK 1), in a Chinese city, explained in English.
 
 ## Play in the terminal
 
 ```sh
-npx silver-tongue
+npx silver-tongue            # continue the game you played last
+npx silver-tongue --new      # start a new game (your other games are kept)
+npx silver-tongue --resume   # choose one of your saved games
 ```
 
 | Key | Does |
 |---|---|
 | `1`–`9` | choose from the menu, or pick a reply |
-| `w` | word help: look up a word from the last line |
+| `w` | word help: look up a word from the last line or the replies; `s` explains the whole sentence |
 | `enter` / `⌫` | say / undo, when building a reply from tiles |
 | `esc` | back |
 | `q` | save and quit (from the menu) |
 
-Progress saves automatically to `~/.config/silver-tongue/<course>.json` (or under `$XDG_CONFIG_HOME`, or `%APPDATA%` on Windows). If a save can't be read, it is kept next to it as `<course>.json.invalid-backup` and a new game starts. If saving fails, the game says so and plays on without saving.
+Progress saves automatically. Each game is one file in `~/.config/silver-tongue/sessions/<course>/` (or under `$XDG_CONFIG_HOME`, or `%APPDATA%` on Windows); a save from 0.2.0 or earlier is moved there on first run. If a save can't be read, it is kept next to it as `<name>.json.invalid-backup` and a new game starts. If saving fails, the game says so and plays on without saving.
 
 Needs Node 22 or newer. Source, issues and other ways to play: https://github.com/jamil314/silver-tongue
 

package/dist/courses/zh-china-en/course.json

@@ -1 +1 @@
-{"id":"zh-china-en","typing":false,"words":{"w0003":{"id":"w0003","w":"三","lv":"1","gloss":"three; 3","pron":"sān"},"w0009":{"id":"w0009","w":"不","lv":"1","gloss":"no; not","pron":"bù"},"w0020":{"id":"w0020","w":"五","lv":"1","gloss":"five; 5","pron":"wǔ"},"w0028":{"id":"w0028","w":"你","lv":"1","gloss":"you (informal)","pron":"nǐ"},"w0037":{"id":"w0037","w":"几","lv":"1","gloss":"how much; how many","pron":"jǐ"},"w0051":{"id":"w0051","w":"吗","lv":"1","gloss":"(question particle for \"yes-no\" questions)","pron":"ma"},"w0060":{"id":"w0060","w":"四","lv":"1","gloss":"four; 4","pron":"sì"},"w0072":{"id":"w0072","w":"好","lv":"1","gloss":"good; appropriate; proper","pron":"hǎo"},"w0084":{"id":"w0084","w":"工作","lv":"1","gloss":"to work; (of a machine) to operate","pron":"gōngzuò"},"w0099":{"id":"w0099","w":"是","lv":"1","gloss":"to be (followed by substantives only); correct; right; true","pron":"shì"},"w0108":{"id":"w0108","w":"水","lv":"1","gloss":"water; river","pron":"shuǐ"},"w0133":{"id":"w0133","w":"茶","lv":"1","gloss":"tea; tea plant","pron":"chá"},"x0001":{"id":"x0001","w":"杯","lv":"1","gloss":"cup; glass (measure word for drinks)","pron":"bēi","bonus":true}},"concepts":{"tea":["w0133"],"water":["w0108"],"three":["w0003"],"four":["w0060"],"five":["w0020"]},"groups":{"drinks":["tea","water"],"numbers_3_5":["three","four","five"]},"world":{"start":"street","currency":"¥","slotsPerDay":4,"startWallet":20,"foodPerDay":5,"rentPerWeek":50,"places":{"street":{"links":["noodle_shop"]},"noodle_shop":{"links":["street"]}},"npcs":{"cook":{"place":"noodle_shop"}}},"scenes":[{"id":"noodle-intro","place":"noodle_shop","npc":"cook","stage":1,"after":[],"requires":{},"repeatable":false,"trustGain":1,"exchanges":[{"id":"greet","slots":{},"expect":{"action":"greet"},"hinges":[],"pay":0,"missCost":0,"variants":{"":{"npc":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}]},"reply":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}]}}}},{"id":"job","slots":{},"expect":{"action":"accept"},"hinges":[],"pay":0,"missCost":0,"variants":{"":{"npc":{"text":"工作，好吗？","tokens":[{"start":0,"end":2,"word":"w0084"},{"start":3,"end":4,"word":"w0072"},{"start":4,"end":5,"word":"w0051"}]},"reply":{"text":"好。","tokens":[{"start":0,"end":1,"word":"w0072"}]}}}}]},{"id":"noodle-shift","place":"noodle_shop","npc":"cook","stage":1,"after":["noodle-intro"],"requires":{"trust":{"cook":1}},"repeatable":true,"trustGain":1,"exchanges":[{"id":"drink","slots":{"item":"drinks"},"expect":{"action":"fetch","item":"$item"},"hinges":["$item"],"pay":1,"missCost":1,"variants":{"item=tea":{"npc":{"text":"茶。","tokens":[{"start":0,"end":1,"word":"w0133"}]},"reply":{"text":"好，茶。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0133"}]}},"item=water":{"npc":{"text":"水。","tokens":[{"start":0,"end":1,"word":"w0108"}]},"reply":{"text":"好，水。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0108"}]}}}},{"id":"order","slots":{"item":"drinks","count":"numbers_3_5"},"expect":{"action":"serve","item":"$item","count":"$count"},"hinges":["$item","$count"],"pay":3,"missCost":2,"variants":{"count=three|item=tea":{"npc":{"text":"三杯茶。","tokens":[{"start":0,"end":1,"word":"w0003"},{"start":1,"end":2,"word":"x0001"},{"start":2,"end":3,"word":"w0133"}]},"reply":{"text":"好，三杯茶。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0003"},{"start":3,"end":4,"word":"x0001"},{"start":4,"end":5,"word":"w0133"}]},"rephrase":{"text":"茶。三杯。","tokens":[{"start":0,"end":1,"word":"w0133"},{"start":2,"end":3,"word":"w0003"},{"start":3,"end":4,"word":"x0001"}]}},"count=three|item=water":{"npc":{"text":"三杯水。","tokens":[{"start":0,"end":1,"word":"w0003"},{"start":1,"end":2,"word":"x0001"},{"start":2,"end":3,"word":"w0108"}]},"reply":{"text":"好，三杯水。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0003"},{"start":3,"end":4,"word":"x0001"},{"start":4,"end":5,"word":"w0108"}]},"rephrase":{"text":"水。三杯。","tokens":[{"start":0,"end":1,"word":"w0108"},{"start":2,"end":3,"word":"w0003"},{"start":3,"end":4,"word":"x0001"}]}},"count=four|item=tea":{"npc":{"text":"四杯茶。","tokens":[{"start":0,"end":1,"word":"w0060"},{"start":1,"end":2,"word":"x0001"},{"start":2,"end":3,"word":"w0133"}]},"reply":{"text":"好，四杯茶。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0060"},{"start":3,"end":4,"word":"x0001"},{"start":4,"end":5,"word":"w0133"}]},"rephrase":{"text":"茶。四杯。","tokens":[{"start":0,"end":1,"word":"w0133"},{"start":2,"end":3,"word":"w0060"},{"start":3,"end":4,"word":"x0001"}]}},"count=four|item=water":{"npc":{"text":"四杯水。","tokens":[{"start":0,"end":1,"word":"w0060"},{"start":1,"end":2,"word":"x0001"},{"start":2,"end":3,"word":"w0108"}]},"reply":{"text":"好，四杯水。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0060"},{"start":3,"end":4,"word":"x0001"},{"start":4,"end":5,"word":"w0108"}]},"rephrase":{"text":"水。四杯。","tokens":[{"start":0,"end":1,"word":"w0108"},{"start":2,"end":3,"word":"w0060"},{"start":3,"end":4,"word":"x0001"}]}},"count=five|item=tea":{"npc":{"text":"五杯茶。","tokens":[{"start":0,"end":1,"word":"w0020"},{"start":1,"end":2,"word":"x0001"},{"start":2,"end":3,"word":"w0133"}]},"reply":{"text":"好，五杯茶。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0020"},{"start":3,"end":4,"word":"x0001"},{"start":4,"end":5,"word":"w0133"}]},"rephrase":{"text":"茶。五杯。","tokens":[{"start":0,"end":1,"word":"w0133"},{"start":2,"end":3,"word":"w0020"},{"start":3,"end":4,"word":"x0001"}]}},"count=five|item=water":{"npc":{"text":"五杯水。","tokens":[{"start":0,"end":1,"word":"w0020"},{"start":1,"end":2,"word":"x0001"},{"start":2,"end":3,"word":"w0108"}]},"reply":{"text":"好，五杯水。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0020"},{"start":3,"end":4,"word":"x0001"},{"start":4,"end":5,"word":"w0108"}]},"rephrase":{"text":"水。五杯。","tokens":[{"start":0,"end":1,"word":"w0108"},{"start":2,"end":3,"word":"w0020"},{"start":3,"end":4,"word":"x0001"}]}}}}]}],"reactions":{"wrong-generic":{"text":"不是。","tokens":[{"start":0,"end":1,"word":"w0009"},{"start":1,"end":2,"word":"w0099"}]},"wrong-count":{"text":"几杯？","tokens":[{"start":0,"end":1,"word":"w0037"},{"start":1,"end":2,"word":"x0001"}]}},"learnerFtl":"# Text-game UI. Every id here is required by packages/tui (UI_KEYS).\n\nhud = Day { $day } · slot { $slot }/{ $slots } · { $currency }{ $wallet } · { $rank }\n\nrank-0 = Pidgin\nrank-1 = Getting By\nrank-2 = Conversational\nrank-3 = Fluent\nrank-4 = Silver Tongue\n\nmenu-title = What now?\nmenu-talk = Talk to { $npc }: { $scene }\nmenu-go = Go to { $place }\nmenu-sleep = Sleep (end the day)\nmenu-quit = Save and quit\n\nkeys-explore = [{ $keys }] choose · [q] quit\nkeys-pick = [{ $keys }] reply · [w] word help\nkeys-tiles = [{ $keys }] add tile · [⌫] undo · [enter] say it · [w] word help\nkeys-help = [{ $keys }] look up · [esc] back\n\nhelp-title = Which word?\nreply-title = Your reply:\ntiles-answer = You say:\nyou = You\n\nmismatch = That's not what they asked for.\nrephrased = (slower)\nwallet-change = { $sign }{ $currency }{ $amount } ({ $reason })\nreason-wages = wages\nreason-mixup = mix-up\nreason-food = food\nreason-rent = rent\ntrust-up = { $npc } trusts you a little more ({ $trust }).\nscene-done = Done. You earned { $currency }{ $earned }.\nunlocked = New: { $scene }\nrank-up = You're now: { $rank }\nday-ended = Day { $day } is over. You sleep.\nreject-unknown-scene = There's nobody here for that.\nreject-in-scene = Finish the conversation first.\nreject-wrong-place = They're not here.\nreject-locked = They're not ready to talk about that yet.\nreject-no-slots = You're out of time today. Sleep first.\nreject-stale-run = That conversation can't continue. Start it again.\nreject-no-pick = Choose a reply with the number keys.\nreject-bad-choice = There's no reply with that number.\nreject-no-tiles = Build your reply from the tiles.\nreject-bad-tile = There's no tile with that number.\nreject-not-linked = You can't get there from here.\nreject-unknown-word = That word isn't in the dictionary.\nnotice-read-only = Your progress can't be saved on this computer, so this session won't be kept.\nnotice-bad-save = Your save couldn't be read. It was kept as a backup and a new game started.\n\nplace-street = The street\nplace-street-desc = Bikes, steam and shouting. A noodle shop glows across the road.\nplace-noodle_shop = Noodle shop\nplace-noodle_shop-desc = Steam everywhere. The cook waves you over.\n\nnpc-cook = Cook\n\nscene-noodle-intro = Get a job\nscene-noodle-shift = Work a shift\n"}
+{"id":"zh-china-en","typing":false,"words":{"w0003":{"id":"w0003","w":"三","lv":"1","gloss":"three; 3","pron":"sān"},"w0009":{"id":"w0009","w":"不","lv":"1","gloss":"no; not","pron":"bù"},"w0010":{"id":"w0010","w":"不客气","lv":"1","gloss":"you're welcome; don't mention it","pron":"bùkèqi"},"w0020":{"id":"w0020","w":"五","lv":"1","gloss":"five; 5","pron":"wǔ"},"w0028":{"id":"w0028","w":"你","lv":"1","gloss":"you (informal)","pron":"nǐ"},"w0034":{"id":"w0034","w":"再见","lv":"1","gloss":"goodbye","pron":"zàijiàn"},"w0037":{"id":"w0037","w":"几","lv":"1","gloss":"how much; how many","pron":"jǐ"},"w0051":{"id":"w0051","w":"吗","lv":"1","gloss":"(question particle for \"yes-no\" questions)","pron":"ma"},"w0060":{"id":"w0060","w":"四","lv":"1","gloss":"four; 4","pron":"sì"},"w0072":{"id":"w0072","w":"好","lv":"1","gloss":"good; appropriate; proper","pron":"hǎo"},"w0079":{"id":"w0079","w":"对不起","lv":"1","gloss":"I'm sorry; excuse me; I beg your pardon","pron":"duìbuqǐ"},"w0084":{"id":"w0084","w":"工作","lv":"1","gloss":"to work; (of a machine) to operate","pron":"gōngzuò"},"w0099":{"id":"w0099","w":"是","lv":"1","gloss":"to be (followed by substantives only); correct; right; true","pron":"shì"},"w0108":{"id":"w0108","w":"水","lv":"1","gloss":"water; river","pron":"shuǐ"},"w0112":{"id":"w0112","w":"没关系","lv":"1","gloss":"it doesn't matter","pron":"méiguānxi"},"w0133":{"id":"w0133","w":"茶","lv":"1","gloss":"tea; tea plant","pron":"chá"},"w0141":{"id":"w0141","w":"谢谢","lv":"1","gloss":"to thank; thanks","pron":"xièxie"},"x0001":{"id":"x0001","w":"杯","lv":"1","gloss":"cup; glass (measure word for drinks)","pron":"bēi","bonus":true}},"concepts":{"tea":["w0133"],"water":["w0108"],"three":["w0003"],"four":["w0060"],"five":["w0020"],"hello":["w0028","w0072"],"thanks":["w0141"],"sorry":["w0079"],"bye":["w0034"]},"groups":{"courtesies":["hello","thanks","sorry","bye"],"drinks":["tea","water"],"numbers_3_5":["three","four","five"]},"world":{"start":"street","currency":"¥","slotsPerDay":4,"startWallet":20,"foodPerDay":5,"rentPerWeek":50,"places":{"street":{"links":["noodle_shop"]},"noodle_shop":{"links":["street"]}},"npcs":{"wang":{"place":"street"},"cook":{"place":"noodle_shop"}}},"scenes":[{"id":"noodle-intro","place":"noodle_shop","npc":"cook","stage":1,"after":["street-hello"],"requires":{},"repeatable":false,"trustGain":1,"exchanges":[{"id":"greet","slots":{},"expect":{"action":"greet"},"hinges":[],"pay":0,"missCost":0,"variants":{"":{"npc":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}],"meaning":"Hello!"},"reply":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}],"meaning":"Hello!"}}}},{"id":"job","slots":{},"expect":{"action":"accept"},"hinges":[],"pay":0,"missCost":0,"variants":{"":{"npc":{"text":"工作，好吗？","tokens":[{"start":0,"end":2,"word":"w0084"},{"start":3,"end":4,"word":"w0072"},{"start":4,"end":5,"word":"w0051"}],"meaning":"Work here — OK?"},"reply":{"text":"好。","tokens":[{"start":0,"end":1,"word":"w0072"}],"meaning":"OK."}}}}]},{"id":"noodle-shift","place":"noodle_shop","npc":"cook","stage":1,"after":["noodle-intro"],"requires":{"trust":{"cook":1}},"repeatable":true,"trustGain":1,"exchanges":[{"id":"drink","slots":{"item":"drinks"},"expect":{"action":"fetch","item":"$item"},"hinges":["$item"],"pay":1,"missCost":1,"variants":{"item=tea":{"npc":{"text":"茶。","tokens":[{"start":0,"end":1,"word":"w0133"}],"meaning":"Tea."},"reply":{"text":"好，茶。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0133"}],"meaning":"OK, tea."}},"item=water":{"npc":{"text":"水。","tokens":[{"start":0,"end":1,"word":"w0108"}],"meaning":"Water."},"reply":{"text":"好，水。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0108"}],"meaning":"OK, water."}}}},{"id":"order","slots":{"item":"drinks","count":"numbers_3_5"},"expect":{"action":"serve","item":"$item","count":"$count"},"hinges":["$item","$count"],"pay":3,"missCost":2,"variants":{"count=three|item=tea":{"npc":{"text":"三杯茶。","tokens":[{"start":0,"end":1,"word":"w0003"},{"start":1,"end":2,"word":"x0001"},{"start":2,"end":3,"word":"w0133"}],"meaning":"Three cups of tea."},"reply":{"text":"好，三杯茶。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0003"},{"start":3,"end":4,"word":"x0001"},{"start":4,"end":5,"word":"w0133"}],"meaning":"OK, three cups of tea."},"rephrase":{"text":"茶。三杯。","tokens":[{"start":0,"end":1,"word":"w0133"},{"start":2,"end":3,"word":"w0003"},{"start":3,"end":4,"word":"x0001"}],"meaning":"Tea. Three cups."}},"count=three|item=water":{"npc":{"text":"三杯水。","tokens":[{"start":0,"end":1,"word":"w0003"},{"start":1,"end":2,"word":"x0001"},{"start":2,"end":3,"word":"w0108"}],"meaning":"Three cups of water."},"reply":{"text":"好，三杯水。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0003"},{"start":3,"end":4,"word":"x0001"},{"start":4,"end":5,"word":"w0108"}],"meaning":"OK, three cups of water."},"rephrase":{"text":"水。三杯。","tokens":[{"start":0,"end":1,"word":"w0108"},{"start":2,"end":3,"word":"w0003"},{"start":3,"end":4,"word":"x0001"}],"meaning":"Water. Three cups."}},"count=four|item=tea":{"npc":{"text":"四杯茶。","tokens":[{"start":0,"end":1,"word":"w0060"},{"start":1,"end":2,"word":"x0001"},{"start":2,"end":3,"word":"w0133"}],"meaning":"Four cups of tea."},"reply":{"text":"好，四杯茶。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0060"},{"start":3,"end":4,"word":"x0001"},{"start":4,"end":5,"word":"w0133"}],"meaning":"OK, four cups of tea."},"rephrase":{"text":"茶。四杯。","tokens":[{"start":0,"end":1,"word":"w0133"},{"start":2,"end":3,"word":"w0060"},{"start":3,"end":4,"word":"x0001"}],"meaning":"Tea. Four cups."}},"count=four|item=water":{"npc":{"text":"四杯水。","tokens":[{"start":0,"end":1,"word":"w0060"},{"start":1,"end":2,"word":"x0001"},{"start":2,"end":3,"word":"w0108"}],"meaning":"Four cups of water."},"reply":{"text":"好，四杯水。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0060"},{"start":3,"end":4,"word":"x0001"},{"start":4,"end":5,"word":"w0108"}],"meaning":"OK, four cups of water."},"rephrase":{"text":"水。四杯。","tokens":[{"start":0,"end":1,"word":"w0108"},{"start":2,"end":3,"word":"w0060"},{"start":3,"end":4,"word":"x0001"}],"meaning":"Water. Four cups."}},"count=five|item=tea":{"npc":{"text":"五杯茶。","tokens":[{"start":0,"end":1,"word":"w0020"},{"start":1,"end":2,"word":"x0001"},{"start":2,"end":3,"word":"w0133"}],"meaning":"Five cups of tea."},"reply":{"text":"好，五杯茶。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0020"},{"start":3,"end":4,"word":"x0001"},{"start":4,"end":5,"word":"w0133"}],"meaning":"OK, five cups of tea."},"rephrase":{"text":"茶。五杯。","tokens":[{"start":0,"end":1,"word":"w0133"},{"start":2,"end":3,"word":"w0020"},{"start":3,"end":4,"word":"x0001"}],"meaning":"Tea. Five cups."}},"count=five|item=water":{"npc":{"text":"五杯水。","tokens":[{"start":0,"end":1,"word":"w0020"},{"start":1,"end":2,"word":"x0001"},{"start":2,"end":3,"word":"w0108"}],"meaning":"Five cups of water."},"reply":{"text":"好，五杯水。","tokens":[{"start":0,"end":1,"word":"w0072"},{"start":2,"end":3,"word":"w0020"},{"start":3,"end":4,"word":"x0001"},{"start":4,"end":5,"word":"w0108"}],"meaning":"OK, five cups of water."},"rephrase":{"text":"水。五杯。","tokens":[{"start":0,"end":1,"word":"w0108"},{"start":2,"end":3,"word":"w0020"},{"start":3,"end":4,"word":"x0001"}],"meaning":"Water. Five cups."}}}}]},{"id":"street-hello","place":"street","npc":"wang","stage":1,"after":[],"requires":{},"repeatable":false,"trustGain":1,"exchanges":[{"id":"hello","slots":{},"expect":{"action":"greet"},"hinges":["hello"],"pay":0,"missCost":0,"variants":{"":{"npc":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}],"meaning":"Hello!"},"reply":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}],"meaning":"Hello!"}}}},{"id":"polite","slots":{"said":"courtesies"},"expect":{"action":"answer","said":"$said"},"hinges":["$said"],"pay":0,"missCost":0,"variants":{"said=hello":{"npc":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}],"meaning":"Hello!"},"reply":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}],"meaning":"Hello!"}},"said=thanks":{"npc":{"text":"谢谢！","tokens":[{"start":0,"end":2,"word":"w0141"}],"meaning":"Thank you!"},"reply":{"text":"不客气！","tokens":[{"start":0,"end":3,"word":"w0010"}],"meaning":"You're welcome!"}},"said=sorry":{"npc":{"text":"对不起！","tokens":[{"start":0,"end":3,"word":"w0079"}],"meaning":"Sorry!"},"reply":{"text":"没关系！","tokens":[{"start":0,"end":3,"word":"w0112"}],"meaning":"That's all right!"}},"said=bye":{"npc":{"text":"再见！","tokens":[{"start":0,"end":2,"word":"w0034"}],"meaning":"Goodbye!"},"reply":{"text":"再见！","tokens":[{"start":0,"end":2,"word":"w0034"}],"meaning":"Goodbye!"}}}},{"id":"polite-again","slots":{"said":"courtesies"},"expect":{"action":"answer","said":"$said"},"hinges":["$said"],"pay":0,"missCost":0,"variants":{"said=hello":{"npc":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}],"meaning":"Hello!"},"reply":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}],"meaning":"Hello!"}},"said=thanks":{"npc":{"text":"谢谢！","tokens":[{"start":0,"end":2,"word":"w0141"}],"meaning":"Thank you!"},"reply":{"text":"不客气！","tokens":[{"start":0,"end":3,"word":"w0010"}],"meaning":"You're welcome!"}},"said=sorry":{"npc":{"text":"对不起！","tokens":[{"start":0,"end":3,"word":"w0079"}],"meaning":"Sorry!"},"reply":{"text":"没关系！","tokens":[{"start":0,"end":3,"word":"w0112"}],"meaning":"That's all right!"}},"said=bye":{"npc":{"text":"再见！","tokens":[{"start":0,"end":2,"word":"w0034"}],"meaning":"Goodbye!"},"reply":{"text":"再见！","tokens":[{"start":0,"end":2,"word":"w0034"}],"meaning":"Goodbye!"}}}},{"id":"bye","slots":{},"expect":{"action":"farewell"},"hinges":["bye"],"pay":0,"missCost":0,"variants":{"":{"npc":{"text":"再见！","tokens":[{"start":0,"end":2,"word":"w0034"}],"meaning":"Goodbye!"},"reply":{"text":"再见！","tokens":[{"start":0,"end":2,"word":"w0034"}],"meaning":"Goodbye!"}}}}]},{"id":"street-practice","place":"street","npc":"wang","stage":1,"after":["street-hello"],"requires":{},"repeatable":true,"trustGain":1,"exchanges":[{"id":"polite-1","slots":{"said":"courtesies"},"expect":{"action":"answer","said":"$said"},"hinges":["$said"],"pay":0,"missCost":0,"variants":{"said=hello":{"npc":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}],"meaning":"Hello!"},"reply":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}],"meaning":"Hello!"}},"said=thanks":{"npc":{"text":"谢谢！","tokens":[{"start":0,"end":2,"word":"w0141"}],"meaning":"Thank you!"},"reply":{"text":"不客气！","tokens":[{"start":0,"end":3,"word":"w0010"}],"meaning":"You're welcome!"}},"said=sorry":{"npc":{"text":"对不起！","tokens":[{"start":0,"end":3,"word":"w0079"}],"meaning":"Sorry!"},"reply":{"text":"没关系！","tokens":[{"start":0,"end":3,"word":"w0112"}],"meaning":"That's all right!"}},"said=bye":{"npc":{"text":"再见！","tokens":[{"start":0,"end":2,"word":"w0034"}],"meaning":"Goodbye!"},"reply":{"text":"再见！","tokens":[{"start":0,"end":2,"word":"w0034"}],"meaning":"Goodbye!"}}}},{"id":"polite-2","slots":{"said":"courtesies"},"expect":{"action":"answer","said":"$said"},"hinges":["$said"],"pay":0,"missCost":0,"variants":{"said=hello":{"npc":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}],"meaning":"Hello!"},"reply":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}],"meaning":"Hello!"}},"said=thanks":{"npc":{"text":"谢谢！","tokens":[{"start":0,"end":2,"word":"w0141"}],"meaning":"Thank you!"},"reply":{"text":"不客气！","tokens":[{"start":0,"end":3,"word":"w0010"}],"meaning":"You're welcome!"}},"said=sorry":{"npc":{"text":"对不起！","tokens":[{"start":0,"end":3,"word":"w0079"}],"meaning":"Sorry!"},"reply":{"text":"没关系！","tokens":[{"start":0,"end":3,"word":"w0112"}],"meaning":"That's all right!"}},"said=bye":{"npc":{"text":"再见！","tokens":[{"start":0,"end":2,"word":"w0034"}],"meaning":"Goodbye!"},"reply":{"text":"再见！","tokens":[{"start":0,"end":2,"word":"w0034"}],"meaning":"Goodbye!"}}}},{"id":"polite-3","slots":{"said":"courtesies"},"expect":{"action":"answer","said":"$said"},"hinges":["$said"],"pay":0,"missCost":0,"variants":{"said=hello":{"npc":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}],"meaning":"Hello!"},"reply":{"text":"你好！","tokens":[{"start":0,"end":1,"word":"w0028"},{"start":1,"end":2,"word":"w0072"}],"meaning":"Hello!"}},"said=thanks":{"npc":{"text":"谢谢！","tokens":[{"start":0,"end":2,"word":"w0141"}],"meaning":"Thank you!"},"reply":{"text":"不客气！","tokens":[{"start":0,"end":3,"word":"w0010"}],"meaning":"You're welcome!"}},"said=sorry":{"npc":{"text":"对不起！","tokens":[{"start":0,"end":3,"word":"w0079"}],"meaning":"Sorry!"},"reply":{"text":"没关系！","tokens":[{"start":0,"end":3,"word":"w0112"}],"meaning":"That's all right!"}},"said=bye":{"npc":{"text":"再见！","tokens":[{"start":0,"end":2,"word":"w0034"}],"meaning":"Goodbye!"},"reply":{"text":"再见！","tokens":[{"start":0,"end":2,"word":"w0034"}],"meaning":"Goodbye!"}}}}]}],"reactions":{"wrong-generic":{"text":"不是。","tokens":[{"start":0,"end":1,"word":"w0009"},{"start":1,"end":2,"word":"w0099"}],"meaning":"No."},"wrong-count":{"text":"几杯？","tokens":[{"start":0,"end":1,"word":"w0037"},{"start":1,"end":2,"word":"x0001"}],"meaning":"How many cups?"}},"learnerFtl":"# Text-game UI. Every id here is required by packages/tui (UI_KEYS).\n\nhud = Day { $day } · slot { $slot }/{ $slots } · { $currency }{ $wallet } · { $rank }\n\nrank-0 = Pidgin\nrank-1 = Getting By\nrank-2 = Conversational\nrank-3 = Fluent\nrank-4 = Silver Tongue\n\nmenu-title = What now?\nmenu-talk = Talk to { $npc }: { $scene }\nmenu-go = Go to { $place }\nmenu-sleep = Sleep (end the day)\nmenu-quit = Save and quit\n\nkeys-explore = [{ $keys }] choose · [q] quit\nkeys-pick = [{ $keys }] reply · [w] word help\nkeys-tiles = [{ $keys }] add tile · [⌫] undo · [enter] say it · [w] word help\nkeys-help = [{ $keys }] look up · [esc] back\nkeys-help-sentence = [{ $keys }] look up · [s] whole sentence · [esc] back\n\nhelp-title = Which word?\nhelp-sentence = The whole sentence\nhelp-in-replies = In the replies:\nreply-title = Your reply:\ntiles-answer = You say:\nyou = You\n\nmismatch = That's not what they asked for.\nrephrased = (slower)\nwallet-change = { $sign }{ $currency }{ $amount } ({ $reason })\nreason-wages = wages\nreason-mixup = mix-up\nreason-food = food\nreason-rent = rent\ntrust-up = { $npc } trusts you a little more ({ $trust }).\nscene-done = Done. You earned { $currency }{ $earned }.\nunlocked = New: { $scene }\nrank-up = You're now: { $rank }\nday-ended = Day { $day } is over. You sleep.\nreject-unknown-scene = There's nobody here for that.\nreject-in-scene = Finish the conversation first.\nreject-wrong-place = They're not here.\nreject-locked = They're not ready to talk about that yet.\nreject-no-slots = You're out of time today. Sleep first.\nreject-stale-run = That conversation can't continue. Start it again.\nreject-no-pick = Choose a reply with the number keys.\nreject-bad-choice = There's no reply with that number.\nreject-no-tiles = Build your reply from the tiles.\nreject-bad-tile = There's no tile with that number.\nreject-not-linked = You can't get there from here.\nreject-unknown-word = That word isn't in the dictionary.\nnotice-read-only = Your progress can't be saved on this computer, so this session won't be kept.\nnotice-bad-save = Your save couldn't be read. It was kept as a backup and a new game started.\n\nresume-title = Your games:\nresume-item = Day { $day } · { $place } · { $currency }{ $wallet } · { $done ->\n    [one] 1 scene done\n   *[other] { $done } scenes done\n} · last played { $date }\nresume-ask = Which one? (number, or enter to cancel)\nresume-none = No saved games yet, so here's a new one.\n\n# The story. intro-1, intro-2, … open a new game ($currency, $wallet, $rent are available).\nintro-1 = Your phone is dead, your wallet is gone, and the bus that brought you here left an hour ago.\nintro-2 = You're standing on a street in a Chinese city with { $currency }{ $wallet } in your pocket. You know nobody, and nobody here speaks your language.\nintro-3 = Food costs money. Rent is { $currency }{ $rent }, due at the end of the week. To earn anything you'll need work, and for work you'll need words.\nintro-4 = On a bench by the road, an old man is watching you with open curiosity. Maybe start there.\n\nplace-street = The street\nplace-street-desc = Bikes, steam and shouting. An old man sits on a bench by the road. Across it, a noodle shop glows.\nplace-noodle_shop = Noodle shop\nplace-noodle_shop-desc = Steam everywhere. The cook is shouting orders at nobody in particular.\n\nnpc-wang = Old Wang\nnpc-cook = Cook\n\n# Scene names for the menu; scene-<id>-start and scene-<id>-end are optional narration.\nscene-street-hello = Say hello\nscene-street-hello-start = The old man pats the bench beside him. \"Wang,\" he says, pointing at himself. He seems to have decided you need lessons: he says something, you answer. Use [w] when you're stuck.\nscene-street-hello-end = Old Wang beams. He points across the road at the noodle shop, mimes slurping noodles, then rubs his fingers together. Work. Money.\n\nscene-street-practice = Practise greetings\nscene-street-practice-start = Old Wang shuffles over to make room. Another lesson, then.\nscene-street-practice-end = Old Wang nods, satisfied, and goes back to watching the street.\n\nscene-noodle-intro = Ask about work\nscene-noodle-intro-start = The cook looks you up and down, wiping her hands on her apron.\nscene-noodle-intro-end = She throws you an apron. You have a job, sort of.\n\nscene-noodle-shift = Work a shift\nscene-noodle-shift-start = Orders fly across the counter. Keep up.\nscene-noodle-shift-end = The rush dies down. The cook counts coins into your hand.\n"}

package/dist/silver-tongue.mjs

@@ -928,8 +928,8 @@ var require_bundle = __commonJS({
 });
 
 // src/main.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
-import { join as join2 } from "node:path";
+import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
+import { createInterface } from "node:readline/promises";
 import { fileURLToPath } from "node:url";
 
 // ../core/src/types.ts
@@ -1167,14 +1167,14 @@ function pickOptions(ctx, ex, combo) {
 }
 function buildTiles(ctx, ex, combo) {
   const rightKey = comboKey(combo);
-  const pieces = tilePieces(ex.variants[rightKey].reply);
+  const pieces2 = tilePieces(ex.variants[rightKey].reply);
   const extra = /* @__PURE__ */ new Set();
   for (const key of shuffle(Object.keys(ex.variants), ctx.rng)) {
     if (key === rightKey) continue;
-    for (const p of tilePieces(ex.variants[key].reply)) if (!pieces.includes(p)) extra.add(p);
+    for (const p of tilePieces(ex.variants[key].reply)) if (!pieces2.includes(p)) extra.add(p);
     if (extra.size >= 2) break;
   }
-  return shuffle([...pieces, ...[...extra].slice(0, 2)], ctx.rng);
+  return shuffle([...pieces2, ...[...extra].slice(0, 2)], ctx.rng);
 }
 function optionsEvent(ex, run) {
   return run.mode === "pick" ? { type: "replyOptions", mode: "pick", options: run.options.map((k) => ex.variants[k].reply) } : { type: "replyOptions", mode: "tiles", tiles: run.tiles };
@@ -1318,9 +1318,9 @@ function isRunShape(x) {
   if (!["pick", "tiles", "type"].includes(x.mode) || !isStrings(x.options) || !isStrings(x.tiles)) return false;
   return ["exchange", "misses", "earned", "mixups"].every((k) => isCount(x[k]));
 }
-function tilesCover(tiles, pieces) {
+function tilesCover(tiles, pieces2) {
   const left = [...tiles];
-  return pieces.every((p) => {
+  return pieces2.every((p) => {
     const i = left.indexOf(p);
     return i >= 0 && left.splice(i, 1).length === 1;
   });
@@ -1439,16 +1439,67 @@ function fitLine(line, cols) {
   if (used < cols) out.push({ text: " ".repeat(cols - used) });
   return out;
 }
+function pieces(line) {
+  const out = [];
+  for (const span of line) {
+    let cur = "";
+    const flush = () => {
+      if (cur) out.push({ text: cur, span });
+      cur = "";
+    };
+    for (const ch of span.text) {
+      const wide = charWidth(ch.codePointAt(0)) === 2;
+      if (ch === " ") cur += ch;
+      else if (wide || cur.endsWith(" ")) {
+        flush();
+        cur = ch;
+        if (wide) flush();
+      } else cur += ch;
+    }
+    flush();
+  }
+  return out;
+}
+function wrapLine(line, cols) {
+  const lines = [];
+  let cur = [];
+  let curFrom;
+  let used = 0;
+  const finish = () => {
+    const last = cur.at(-1);
+    if (last) last.text = last.text.replace(/ +$/, "");
+    lines.push(cur.filter((s) => s.text));
+    cur = [];
+    curFrom = void 0;
+    used = 0;
+  };
+  const add = ({ text, span }) => {
+    if (used > 0 && used + strWidth(text.replace(/ +$/, "")) > cols) finish();
+    if (used === 0 && lines.length > 0) text = text.replace(/^ +/, "");
+    if (!text) return;
+    if (curFrom === span) cur[cur.length - 1].text += text;
+    else cur.push({ ...span, text });
+    curFrom = span;
+    used += strWidth(text);
+  };
+  for (const p of pieces(line)) {
+    if (strWidth(p.text.replace(/ +$/, "")) > cols) for (const ch of p.text) add({ text: ch, span: p.span });
+    else add(p);
+  }
+  finish();
+  return lines;
+}
 
 // ../tui/src/text.ts
 var import_bundle = __toESM(require_bundle(), 1);
 function makeText(ftl, locale = "en") {
   const bundle = new import_bundle.FluentBundle(locale, { useIsolating: false });
   bundle.addResource(new import_bundle.FluentResource(ftl));
-  return (id, args) => {
+  const t = (id, args) => {
     const msg = bundle.getMessage(id);
     return msg?.value ? bundle.formatPattern(msg.value, args ?? {}, []) : id;
   };
+  return Object.assign(t, { has: (id) => !!bundle.getMessage(id)?.value });
 }
 var UI_KEYS = {
   hud: ["day", "slot", "slots", "currency", "wallet", "rank"],
@@ -1466,6 +1517,9 @@ var UI_KEYS = {
   "keys-pick": ["keys"],
   "keys-tiles": ["keys"],
   "keys-help": ["keys"],
+  "keys-help-sentence": ["keys"],
+  "help-sentence": [],
+  "help-in-replies": [],
   "help-title": [],
   "reply-title": [],
   "tiles-answer": [],
@@ -1481,6 +1535,10 @@ var UI_KEYS = {
   "day-ended": ["day"],
   "notice-bad-save": [],
   "notice-read-only": [],
+  "resume-title": [],
+  "resume-item": ["day", "place", "currency", "wallet", "done", "date"],
+  "resume-ask": [],
+  "resume-none": [],
   ...Object.fromEntries(REJECT_REASONS.map((c) => [`reject-${c}`, []]))
 };
 
@@ -1524,9 +1582,10 @@ function border(left, label, right, fill, cols, rightLabel = "") {
 function renderScreen(m, cols, rows) {
   const inner = Math.max(1, cols - 4);
   const bodyRows = Math.max(1, rows - 2);
-  const prompt = m.prompt.slice(-bodyRows);
+  const wrap = (lines) => lines.flatMap((l) => wrapLine(l, inner));
+  const prompt = wrap(m.prompt).slice(-bodyRows);
   const logRows = Math.max(0, bodyRows - prompt.length - (prompt.length ? 1 : 0));
-  const log = logRows > 0 ? m.log.slice(-logRows) : [];
+  const log = logRows > 0 ? wrap(m.log).slice(-logRows) : [];
   const body = [...Array(logRows - log.length).fill([]), ...log];
   if (prompt.length) body.push([]);
   body.push(...prompt);
@@ -1550,6 +1609,7 @@ function startApp(opts) {
   let replyMode = "pick";
   let tileInput = [];
   let lastLine = null;
+  let resuming = false;
   const push = (...lines) => {
     log = [...log, ...lines].slice(-LOG_LIMIT);
   };
@@ -1560,6 +1620,16 @@ function startApp(opts) {
   ];
   const keyRange = (n) => n <= 1 ? "1" : `1-${Math.min(n, 9)}`;
   const echo = (text) => push([{ text: `${t("you")}: `, color: "green", bold: true }, { text }]);
+  const narrate = (id, args) => {
+    if (t.has(id)) push([{ text: t(id, args), dim: true }]);
+  };
+  function tellIntro() {
+    const s = core2.state;
+    const fresh = s.day === 1 && s.slot === 0 && !s.run && s.place === course2.world.start && !Object.keys(s.scenesDone).length && !Object.keys(s.words).length;
+    if (!fresh) return;
+    const args = { currency: course2.world.currency, wallet: s.wallet, rent: course2.world.rentPerWeek };
+    for (let i = 1; t.has(`intro-${i}`); i++) push([{ text: t(`intro-${i}`, args) }], []);
+  }
   function enterPlace(place) {
     push([], [{ text: t(`place-${place}`), bold: true }], [{ text: t(`place-${place}-desc`), dim: true }]);
   }
@@ -1575,6 +1645,7 @@ function startApp(opts) {
         case "sceneStarted":
           mode = "scene";
           push([]);
+          if (!resuming) narrate(`scene-${e.scene}-start`);
           break;
         case "lineSpoken":
           lastLine = e.line;
@@ -1614,6 +1685,7 @@ function startApp(opts) {
           break;
         case "sceneEnded":
           mode = "explore";
+          narrate(`scene-${e.scene}-end`);
           push([{ text: t("scene-done", { currency: course2.world.currency, earned: e.earned }), bold: true }]);
           break;
         case "unlocked":
@@ -1660,16 +1732,28 @@ function startApp(opts) {
   }
   function helpWords() {
     if (!lastLine) return [];
-    const line = lastLine;
-    return line.tokens.map((tk) => ({ text: line.text.slice(tk.start, tk.end), word: tk.word }));
+    const pieces2 = (l) => l.tokens.map((tk) => ({ text: l.text.slice(tk.start, tk.end), word: tk.word }));
+    const said = pieces2(lastLine).map((p) => ({ ...p, inReplies: false }));
+    const seen = new Set(said.map((p) => p.word));
+    const replies = replyMode === "pick" ? pickOptions2.flatMap(pieces2) : [];
+    const extra = replies.filter((p) => !seen.has(p.word) && seen.add(p.word)).map((p) => ({ ...p, inReplies: true }));
+    return [...said, ...extra].slice(0, 9);
   }
   function prompt(width) {
     if (mode === "explore") {
       return [[{ text: t("menu-title"), dim: true }], ...menu().map((m, i) => [{ text: `${i + 1}) ${m.label}` }])];
     }
     if (mode === "help") {
-      const words = helpWords().map((w, i) => `${i + 1}) ${w.text}`);
-      return [[{ text: t("help-title"), dim: true }], ...wrapItems(words, width)];
+      const items = helpWords().map((w, i) => ({ ...w, label: `${i + 1}) ${w.text}` }));
+      const said = items.filter((w) => !w.inReplies).map((w) => w.label);
+      const inReplies = items.filter((w) => w.inReplies).map((w) => w.label);
+      const sentence = lastLine?.meaning ? [[{ text: `s) ${t("help-sentence")}` }]] : [];
+      return [
+        [{ text: t("help-title"), dim: true }],
+        ...wrapItems(said, width),
+        ...sentence,
+        ...inReplies.length ? [[{ text: t("help-in-replies"), dim: true }], ...wrapItems(inReplies, width)] : []
+      ];
     }
     const title = [{ text: t("reply-title"), dim: true }];
     if (replyMode === "pick") return [title, ...pickOptions2.map((o, i) => [{ text: `${i + 1}) ` }, ...lineSpans(o, /* @__PURE__ */ new Set())])];
@@ -1694,7 +1778,7 @@ function startApp(opts) {
       wallet: s.wallet,
       rank: t(`rank-${rankFor(s.words, wordIds, opts.now())}`)
     });
-    const [footerId, count] = mode === "explore" ? ["keys-explore", menu().length] : mode === "help" ? ["keys-help", helpWords().length] : replyMode === "pick" ? ["keys-pick", pickOptions2.length] : ["keys-tiles", tiles.length];
+    const [footerId, count] = mode === "explore" ? ["keys-explore", menu().length] : mode === "help" ? [lastLine?.meaning ? "keys-help-sentence" : "keys-help", helpWords().length] : replyMode === "pick" ? ["keys-pick", pickOptions2.length] : ["keys-tiles", tiles.length];
     const footer = t(footerId, { keys: keyRange(count) });
     term2.write(renderScreen({ title: t(`place-${s.place}`), hud, log, prompt: prompt(cols - 4), footer }, cols, rows));
   }
@@ -1716,6 +1800,14 @@ function startApp(opts) {
           { text: ` \u2014 ${w.gloss}` }
         ]);
       }
+      if (key.name === "s" && lastLine?.meaning) {
+        const pron = lastLine.tokens.flatMap((tk) => course2.words[tk.word]?.pron ?? []).join(" ");
+        push([
+          { text: lastLine.text, bold: true },
+          ...pron ? [{ text: ` ${pron}`, color: "yellow" }] : [],
+          { text: ` \u2014 ${lastLine.meaning}` }
+        ]);
+      }
       if (key.name === "escape" || key.name === "w") mode = "scene";
     } else if (key.name === "w") {
       mode = "help";
@@ -1735,14 +1827,63 @@ function startApp(opts) {
     render();
   }
   if (opts.notice) push([{ text: t(opts.notice), color: "yellow" }]);
+  tellIntro();
   enterPlace(core2.state.place);
+  resuming = true;
   apply(describeRun(course2, core2.state));
+  resuming = false;
   term2.onKey(press);
   term2.onResize(render);
   render();
   return { press, render };
 }
 
+// src/cli.ts
+import { parseArgs } from "node:util";
+var USAGE = `Usage: silver-tongue [--new | --resume]
+
+  (no flag)   continue the game you played last
+  --new       start a new game (your other games are kept)
+  --resume    choose one of your saved games
+  --help      show this help`;
+function parseFlags(args) {
+  let parsed;
+  try {
+    parsed = parseArgs({
+      args,
+      allowPositionals: true,
+      options: { new: { type: "boolean" }, resume: { type: "boolean" }, help: { type: "boolean", short: "h" } }
+    });
+  } catch (e) {
+    const unknown = /Unknown option '([^']+)'/.exec(e.message);
+    return { mode: "error", message: unknown ? `unknown option ${unknown[1]}` : e.message };
+  }
+  const { values, positionals } = parsed;
+  if (values.help) return { mode: "help" };
+  if (values.new && values.resume) return { mode: "error", message: "use --new or --resume, not both" };
+  const mode = values.new ? "new" : values.resume ? "resume" : "continue";
+  return positionals[0] ? { mode, coursePath: positionals[0] } : { mode };
+}
+function sessionLines(sessions, course2, t, date) {
+  return sessions.map((s, i) => {
+    const text = t("resume-item", {
+      day: s.state.day,
+      place: t(`place-${s.state.place}`),
+      currency: course2.world.currency,
+      wallet: s.state.wallet,
+      done: Object.values(s.state.scenesDone).filter((n) => n > 0).length,
+      date: date(s.lastPlayed)
+    });
+    return `${i + 1}) ${text}`;
+  });
+}
+function pickAnswer(answer, count) {
+  const a = answer.trim().toLowerCase();
+  if (a === "" || a === "q") return "cancel";
+  const n = Number(a);
+  return Number.isInteger(n) && n >= 1 && n <= count ? n - 1 : "again";
+}
+
 // src/node-terminal.ts
 import readline from "node:readline";
 var COLORS = { red: 31, green: 32, yellow: 33, magenta: 35, cyan: 36 };
@@ -1764,6 +1905,7 @@ function keyName(str, key) {
 function createNodeTerminal(input = process.stdin, output = process.stdout) {
   readline.emitKeypressEvents(input);
   if (input.isTTY) input.setRawMode(true);
+  input.resume();
   output.write("\x1B[?1049h\x1B[?25l");
   const handlers = [];
   input.on("keypress", (str, key) => {
@@ -1800,20 +1942,55 @@ function createNodeTerminal(input = process.stdin, output = process.stdout) {
   };
 }
 
+// src/sessions.ts
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, statSync } from "node:fs";
+import { join } from "node:path";
+function sessionsDir(configRoot, courseId) {
+  return join(configRoot, "silver-tongue", "sessions", courseId);
+}
+function listSessions(dir, course2) {
+  if (!existsSync(dir)) return [];
+  const out = [];
+  for (const file of readdirSync(dir)) {
+    if (!file.endsWith(".json")) continue;
+    const path = join(dir, file);
+    try {
+      const parsed = parseSave(readFileSync(path, "utf8"), course2);
+      if (parsed.ok) out.push({ id: file.slice(0, -5), path, lastPlayed: statSync(path).mtimeMs, state: parsed.state });
+    } catch {
+    }
+  }
+  return out.sort((a, b) => b.lastPlayed - a.lastPlayed || b.id.localeCompare(a.id));
+}
+var stamp = (ms) => new Date(ms).toISOString().slice(0, 19).replace("T", "-").replace(/:/g, "");
+function newSessionPath(dir, now) {
+  const base2 = stamp(now);
+  let path = join(dir, `${base2}.json`);
+  for (let n = 2; existsSync(path); n++) path = join(dir, `${base2}-${n}.json`);
+  return path;
+}
+function migrateLegacySave(configRoot, courseId) {
+  const legacy = join(configRoot, "silver-tongue", `${courseId}.json`);
+  if (!existsSync(legacy)) return;
+  const dir = sessionsDir(configRoot, courseId);
+  mkdirSync(dir, { recursive: true });
+  renameSync(legacy, newSessionPath(dir, statSync(legacy).mtimeMs));
+}
+
 // src/storage.ts
-import { closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, renameSync, writeSync } from "node:fs";
+import { closeSync, existsSync as existsSync2, fsyncSync, mkdirSync as mkdirSync2, openSync, readFileSync as readFileSync2, renameSync as renameSync2, writeSync } from "node:fs";
 import { homedir } from "node:os";
-import { dirname, join } from "node:path";
+import { dirname, join as join2 } from "node:path";
 function configDir(env = process.env, platform = process.platform, home = homedir()) {
-  if (platform === "win32") return env.APPDATA || join(home, "AppData", "Roaming");
-  return env.XDG_CONFIG_HOME || join(home, ".config");
+  if (platform === "win32") return env.APPDATA || join2(home, "AppData", "Roaming");
+  return env.XDG_CONFIG_HOME || join2(home, ".config");
 }
 function loadSave(course2, path) {
   try {
-    if (!existsSync(path)) return { state: newGame(course2), readOnly: false };
-    const parsed = parseSave(readFileSync(path, "utf8"), course2);
+    if (!existsSync2(path)) return { state: newGame(course2), readOnly: false };
+    const parsed = parseSave(readFileSync2(path, "utf8"), course2);
     if (parsed.ok) return { state: parsed.state, readOnly: false };
-    renameSync(path, `${path}.invalid-backup`);
+    renameSync2(path, `${path}.invalid-backup`);
     return { state: newGame(course2), notice: "notice-bad-save", readOnly: false };
   } catch {
     return { state: newGame(course2), notice: "notice-read-only", readOnly: true };
@@ -1821,7 +1998,7 @@ function loadSave(course2, path) {
 }
 function writeSave(path, state2) {
   try {
-    mkdirSync(dirname(path), { recursive: true });
+    mkdirSync2(dirname(path), { recursive: true });
     const tmp = `${path}.tmp`;
     const fd = openSync(tmp, "w");
     try {
@@ -1830,7 +2007,7 @@ function writeSave(path, state2) {
     } finally {
       closeSync(fd);
     }
-    renameSync(tmp, path);
+    renameSync2(tmp, path);
     return true;
   } catch {
     return false;
@@ -1839,13 +2016,13 @@ function writeSave(path, state2) {
 
 // src/main.ts
 var COURSE = "zh-china-en";
-function coursePath() {
-  if (process.argv[2]) return process.argv[2];
+function coursePath(given) {
+  if (given) return given;
   const candidates = [
     new URL(`./courses/${COURSE}/course.json`, import.meta.url),
     new URL(`../../../dist/courses/${COURSE}/course.json`, import.meta.url)
   ].map((u) => fileURLToPath(u));
-  const found = candidates.find((p) => existsSync2(p));
+  const found = candidates.find((p) => existsSync3(p));
   if (!found) {
     console.error(`No built course found. Run: npm run build:course`);
     process.exit(1);
@@ -1857,8 +2034,48 @@ if (major < 22) {
   console.error(`silver-tongue needs Node 22 or newer; this is Node ${process.versions.node}.`);
   process.exit(1);
 }
-var course = JSON.parse(readFileSync2(coursePath(), "utf8"));
-var savePath = process.env.SILVER_TONGUE_SAVE ?? join2(configDir(), "silver-tongue", `${course.id}.json`);
+var flags = parseFlags(process.argv.slice(2));
+if (flags.mode === "help") {
+  console.log(USAGE);
+  process.exit(0);
+}
+if (flags.mode === "error") {
+  console.error(`silver-tongue: ${flags.message}
+
+${USAGE}`);
+  process.exit(2);
+}
+var course = JSON.parse(readFileSync3(coursePath(flags.coursePath), "utf8"));
+async function chooseSave() {
+  if (process.env.SILVER_TONGUE_SAVE) return process.env.SILVER_TONGUE_SAVE;
+  const root = configDir();
+  const dir = sessionsDir(root, course.id);
+  try {
+    migrateLegacySave(root, course.id);
+  } catch {
+  }
+  const sessions = listSessions(dir, course);
+  if (flags.mode === "continue") return sessions[0]?.path ?? newSessionPath(dir, Date.now());
+  if (flags.mode === "new") return newSessionPath(dir, Date.now());
+  const t = makeText(course.learnerFtl);
+  if (!sessions.length) {
+    console.log(t("resume-none"));
+    return newSessionPath(dir, Date.now());
+  }
+  console.log(t("resume-title"));
+  for (const line of sessionLines(sessions, course, t, (ms) => new Date(ms).toLocaleString())) console.log(line);
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    for (; ; ) {
+      const pick = pickAnswer(await rl.question(`${t("resume-ask")} `), sessions.length);
+      if (pick === "cancel") process.exit(0);
+      if (pick !== "again") return sessions[pick].path;
+    }
+  } finally {
+    rl.close();
+  }
+}
+var savePath = await chooseSave();
 var { state, notice, readOnly } = loadSave(course, savePath);
 var core = createCore(course, state, { now: Date.now, rng: mulberry32(Date.now() >>> 0) });
 var term = createNodeTerminal();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "silver-tongue",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Learn a language by living in it: a text game for the terminal.",
   "type": "module",
   "repository": { "type": "git", "url": "git+https://github.com/jamil314/silver-tongue.git", "directory": "packages/tui-node" },