Add Pac-Man power-on flow and document Odin integration

- Add a four-second arcade-style boot sequence followed by the
  Character / Nickname introduction.
- Separate cabinet power-on from RFID credit and player Start.
- Add operator Power on control and cabinet power-state reporting.
- Prevent repeated power commands from restarting boot or gameplay.
- Ignore RFID scans received before the cabinet is ready.
- Add power-state, RFID, controller, and GPIO feedback regression tests.

- Expand the master walkthrough with export, packaging, file transfer,
  fresh-Pi setup, RFID compilation, and end-to-end testing instructions.
- Correct tester hardware documentation: BCM23/J20 drives an LED;
  physical buttons connect through a separate I2C1 input board.
- Document operator-triggered power-on as the current test workflow
  and retain the temporary 2.4 configuration compatibility notes.
- Record successful physical testing of power-on, RFID credit,
  and player Start.

- Add an Odin integration README describing the proposed Rust/NATS
  bridge, shared messages, Flutter GM interface, autopilot sequencing,
  hardware ownership, and Starfish SSH-management role.
- Define migration milestones and information needed from the
  framework owner; link the integration guide from the root README.

Validation: 69 controller tests, 10 GPIO tests, Pac-Man power/RFID
checks, managed-cabinet lifecycle checks, and visual screen inspection.

tests/room_network/test_objectives.py

@@ -65,14 +65,30 @@ class ObjectiveTests(unittest.TestCase):
         self.fleet=test_fleet.server.Fleet(':memory:',self.catalog,lambda:self.now)
         self.poll('cabinet_01')
         room=self.fleet.rooms['cabinet_01']
-        room.features=['assignment_config_v1','rfid_credit_v1']
+        room.features=['assignment_config_v1','rfid_credit_v1','pacman_power_v1']
         room.gpio='real'
         self.fleet.operator('prepare_scenario', {'scenario':'pacman_rfid_credit_test'})
-        command=self.poll('cabinet_01')['commands'][0]
+        command=room.poll(dict(cabinet='cabinet_01',protocol=2,boot='cabinet_01',features=room.features,gpio='real',reports=[]))['commands'][0]
         self.assertEqual(command['game_config']['rfid_credit_device'],'cab1_rfid1')
         self.assertEqual(command['type'],'prepare')
-        self.poll('cabinet_01',[dict(kind='ack',id=command['id'],session=command['session'],ok=True)])
+        room.ack(dict(id=command['id'],ok=True))
+        self.assertEqual(room.state['phase'],'powered_off')
+        room.event(dict(id='power',event='power_booting'))
+        self.assertEqual(room.state['phase'],'booting')
+        room.event(dict(id='booted',event='power_ready'))
         self.assertEqual(room.state['phase'],'ready')
         self.assertFalse(any(c['type'] in ('output','reward','start') for c in room.state['commands']))
         self.poll('cabinet_01',[dict(kind='event',id='physical-start',session=command['session'],event='started')])
         self.assertEqual(room.state['phase'],'playing')
+
+    def test_power_validation(self):
+        room=self.fleet.rooms['cabinet_01']
+        room.gpio='real'
+        self.catalog['cabinets']['cabinet_01']['devices']=[dict(id='button',kind='input')]
+        item=dict(cabinet='cabinet_01',game='pacman',game_config=dict(power_on_device='button'))
+        with self.assertRaisesRegex(ValueError,'2.4'): self.fleet.validate_assignment(item)
+        room.features.append('pacman_power_v1')
+        self.fleet.validate_assignment(item)
+        for value in ['missing',True,17]:
+            with self.assertRaises(ValueError): self.fleet.validate_assignment(dict(item,game_config=dict(power_on_device=value)))
+        with self.assertRaises(ValueError): self.fleet.validate_assignment(dict(item,activate_after_win='cabinet_02'))

tests/room_network/test_power.py

@@ -0,0 +1,35 @@
+import unittest
+from test_room import server
+
+class PowerTests(unittest.TestCase):
+    def setUp(self):
+        self.room=server.Room(':memory:',lambda:100)
+        self.room.poll(dict(cabinet='cabinet_01',protocol=2,boot='a',features=['pacman_power_v1'],reports=[]))
+        self.room.state.update(game='pacman',game_config={'power_on_device':'button'},mappings={})
+    def tearDown(self): self.room.db.close()
+    def prepare(self):
+        self.room.operator('prepare')
+        command=self.room.state['commands'][-1]
+        self.room.ack(dict(id=command['id'],ok=True))
+    def test_operator_power_and_duplicate_events(self):
+        self.prepare()
+        self.assertEqual(self.room.state['phase'],'powered_off')
+        with self.assertRaises(ValueError): self.room.operator('start')
+        self.room.operator('power_on')
+        command=self.room.state['commands'][-1]
+        self.room.ack(dict(id=command['id'],ok=True))
+        self.assertEqual(self.room.state['phase'],'booting')
+        with self.assertRaises(ValueError): self.room.operator('start')
+        self.room.event(dict(id='booted',event='power_ready'))
+        self.assertEqual(self.room.state['phase'],'ready')
+        with self.assertRaises(ValueError): self.room.operator('power_on')
+        self.room.event(dict(id='booted',event='power_ready'))
+        self.assertEqual(self.room.state['phase'],'ready')
+    def test_dependency_autostart_waits_for_boot(self):
+        self.room.state.update(game_config={},auto_start=True)
+        self.prepare()
+        self.assertEqual(self.room.state['phase'],'booting')
+        self.assertFalse(any(c['type']=='start' for c in self.room.state['commands']))
+        self.room.event(dict(id='booted',event='power_ready'))
+        self.assertEqual(self.room.state['phase'],'starting')
+        self.assertEqual(sum(c['type']=='start' for c in self.room.state['commands']),1)