Add staging gameplay smoke artifact output

lobby/management/commands/smoke_staging.py

@@ -1,4 +1,6 @@
 import json
+from datetime import datetime, timezone
+from pathlib import Path
 
 from django.contrib.auth import get_user_model
 from django.core.management.base import BaseCommand, CommandError
@@ -10,6 +12,12 @@ from fupogfakta.models import Category, GameSession, Player, Question, RoundQues
 class Command(BaseCommand):
     help = "Run minimal staging smoke flow for lobby gameplay"
 
+    def add_arguments(self, parser):
+        parser.add_argument(
+            "--artifact",
+            help="Optional path to write smoke result artifact as JSON",
+        )
+
     def handle(self, *args, **options):
         GameSession.objects.all().delete()
         Player.objects.all().delete()
@@ -127,4 +135,30 @@ class Command(BaseCommand):
         if finish_res.status_code != 200:
             raise CommandError(f"finish_game failed: {finish_res.status_code}")
 
+        artifact_path = options.get("artifact")
+        if artifact_path:
+            artifact = {
+                "ok": True,
+                "command": "smoke_staging",
+                "generated_at": datetime.now(timezone.utc).isoformat(),
+                "session_code": code,
+                "players": [player["nickname"] for player in players],
+                "round_question_id": round_question_id,
+                "steps": [
+                    "create_session",
+                    "join_players",
+                    "start_round",
+                    "show_question",
+                    "submit_lies",
+                    "mix_answers",
+                    "submit_guesses",
+                    "calculate_scores",
+                    "reveal_scoreboard",
+                    "finish_game",
+                ],
+            }
+            output_path = Path(artifact_path)
+            output_path.parent.mkdir(parents=True, exist_ok=True)
+            output_path.write_text(json.dumps(artifact, indent=2) + "\n", encoding="utf-8")
+
         self.stdout.write(self.style.SUCCESS(f"Smoke flow OK for session {code}"))

lobby/tests.py

@@ -1,4 +1,7 @@
+import json
+import tempfile
 from datetime import timedelta
+from pathlib import Path
 
 from django.contrib.auth import get_user_model
 from django.core.management import call_command
@@ -972,3 +975,31 @@ class SmokeStagingCommandTests(TestCase):
         session = GameSession.objects.latest("created_at")
         self.assertEqual(session.status, GameSession.Status.FINISHED)
         self.assertEqual(Player.objects.filter(session=session).count(), 3)
+
+    def test_smoke_staging_writes_artifact_when_requested(self):
+        with tempfile.TemporaryDirectory() as tmp_dir:
+            artifact_path = Path(tmp_dir) / "smoke.json"
+            call_command("smoke_staging", artifact=str(artifact_path))
+
+            self.assertTrue(artifact_path.exists())
+            payload = json.loads(artifact_path.read_text(encoding="utf-8"))
+            self.assertTrue(payload["ok"])
+            self.assertEqual(payload["command"], "smoke_staging")
+            self.assertEqual(payload["players"], ["P1", "P2", "P3"])
+            self.assertIn("generated_at", payload)
+            self.assertIn("session_code", payload)
+            self.assertEqual(
+                payload["steps"],
+                [
+                    "create_session",
+                    "join_players",
+                    "start_round",
+                    "show_question",
+                    "submit_lies",
+                    "mix_answers",
+                    "submit_guesses",
+                    "calculate_scores",
+                    "reveal_scoreboard",
+                    "finish_game",
+                ],
+            )