port-layer papercuts for the playtest: #69 Denkou rename, #71 plasma X=minimize, #157 round-end UX (foreground handoff + lastrun clean-exit markers + bat sign-off rewording); tester-facing open-issues handout (docs/) + field-log anatomy notes

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

game/btl4main.cpp

@@ -234,6 +234,36 @@ static LONG WINAPI
 	return EXCEPTION_EXECUTE_HANDLER;		// die (after the evidence is out)
 }
 
+//
+// lastrun_<stem>.txt clean-exit markers (#157, 2026-08-10): the launch record
+// only ever said "exe reached WinMain", so a night that ended with the player
+// closing the menu was indistinguishable from a silent death -- and the bat's
+// sign-off taught players to report normal quits as crashes.  The deliberate
+// exit paths stamp the record themselves now, so the file answers "crash or
+// quit?" on its own.  Name captured at breadcrumb time (cwd is content\ by
+// then -- the same file the bats bracket).
+//
+static char gBTLastrunName[MAX_PATH] = "";
+
+void
+	BTLastrunNote(const char *note)
+{
+	if (gBTLastrunName[0] == 0)
+	{
+		return;
+	}
+	SYSTEMTIME lt;
+	GetLocalTime(&lt);
+	std::ofstream f(gBTLastrunName, std::ios::out | std::ios::app);
+	if (f.is_open())
+	{
+		char stamp[64];
+		wsprintfA(stamp, "[%04d-%02d-%02d %02d:%02d:%02d] ",
+			lt.wYear, lt.wMonth, lt.wDay, lt.wHour, lt.wMinute, lt.wSecond);
+		f << stamp << note << "\n";
+	}
+}
+
 //===========================================================================//
 // environ.ini -- the player's settings file (cwd = content\).  One KEY=VALUE
 // per line; the real environment always WINS, so a launcher .bat or a shell
@@ -833,6 +863,7 @@ int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine
 		GetComputerNameA(machine, &machine_len);
 		char lastrun_name[MAX_PATH];
 		wsprintfA(lastrun_name, "lastrun_%s.txt", logStem);
+		lstrcpynA(gBTLastrunName, lastrun_name, MAX_PATH);
 		std::ofstream breadcrumb(lastrun_name, std::ios::out | std::ios::app);
 		if (breadcrumb.is_open())
 		{
@@ -1209,6 +1240,7 @@ int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine
 			BTFeLaunchSpec fe_spec;
 			if (BTFrontEnd_Run(&fe_spec) != 0 || fe_spec.mode == BTFeLaunchNone)
 			{
+				BTLastrunNote("clean exit: player quit from the menu");
 				return 0;						// quit from the menu
 			}
 			char fe_arguments[192];

game/glass/btl4console.cpp

@@ -174,6 +174,8 @@ void
 		{
 			MarshalLog("window closed by the user -- exiting for real "
 				"(no relaunch)");
+			extern void BTLastrunNote(const char *);
+			BTLastrunNote("clean exit: player closed the game window");
 			ExitProcess(0);
 		}
 	}
@@ -257,6 +259,16 @@ void
 	if (CreateProcessW(exe_path, command_line, NULL, NULL, FALSE,
 		0, NULL, NULL, &startup, &process))
 	{
+		// Hand the child our foreground right BEFORE we die (#157): Windows
+		// refuses SetForegroundWindow to a process spawned by an exiting
+		// background parent, so the round-end menu could open BEHIND the
+		// desktop clutter -- which is how a normal between-rounds relaunch
+		// read as "the game crashed" from the cockpit seat.
+		if (!AllowSetForegroundWindow(process.dwProcessId))
+		{
+			MarshalLog("foreground handoff denied -- the next window may "
+				"open behind");
+		}
 		CloseHandle(process.hThread);
 		CloseHandle(process.hProcess);
 	}

game/glass/btl4fe.cpp

@@ -412,7 +412,7 @@ static const CatalogEntry kVehicles[] =
 	{ "avatar",		"Avatar" },
 	{ "ava1",		"Satyr" },
 	{ "sunder",		"Sunder" },
-	{ "snd1",		"Sunder V1" },
+	{ "snd1",		"Denkou" },		// #69: the 4.x-era name (two era witnesses)
 	{ "vulture",	"Vulture" },
 	{ "vul1",		"Mad Dog" },
 	{ "lok2",		"Mischief" },