Phase 6: strip signature-restating docstrings; correct README/SETUP

- Collapsed Args:/Returns:/Raises: blocks that only restated the
  signature (364 lines): tektronix_base 48% -> ~20% doc density,
  helios_laser and uc480_camera likewise. Only docstrings whose entire
  body was those sections were touched.
- Preserved verbatim the comments that carry hardware knowledge the code
  can't express: uc480's USB split-transaction contention note (with its
  measured fps), the IS_ALLOW_STARTER_FW_UPLOAD segfault explanation, the
  QImage-copy rationale, and tektronix's NUMFRAMESACQuired warning.
- README: project structure, quick start, and every usage example now
  describe code that exists (they referenced hardware/bbd202.py,
  CoherentHOPSLaser, get_curve_binary, and 'python -m scanengine.app',
  none of which do). Added a headless-scan example and a read-a-scan-file
  example, since reuse without the GUI is the point of the refactor.
- SETUP: structure section defers to README instead of keeping a second
  stale copy; documents the vendored uEye SDK and the Genesis quarantine.
- ruff is now clean repo-wide: fixed the remaining raise-from, unused
  loop variables, placeholder f-strings, and a non-strict zip; the
  widget-layout semicolon idiom is an explicit config ignore rather than
  22 standing warnings.

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

hardware/helios_laser.py

@@ -29,13 +29,7 @@ class HeliosLaser:
     """
 
     def __init__(self, port: str = None, timeout: float = 1.0):
-        """
-        Initialize Helios laser driver.
-
-        Args:
-            port: Serial port (e.g., '/dev/ttyUSB0' or 'COM5')
-            timeout: Serial timeout in seconds
-        """
+        """Initialize Helios laser driver."""
         self.port = port
         self.timeout = timeout
         self.serial = None
@@ -48,15 +42,7 @@ class HeliosLaser:
         return list_port_devices()
 
     def connect(self, port: str = None) -> bool:
-        """
-        Connect to the Helios laser.
-
-        Args:
-            port: Serial port (uses stored port if None)
-
-        Returns:
-            True if connection successful
-        """
+        """Connect to the Helios laser."""
         if port:
             self.port = port
 
@@ -91,15 +77,7 @@ class HeliosLaser:
         self.serial = None
 
     def _send_command(self, command: str) -> bool:
-        """
-        Send a command to the laser.
-
-        Args:
-            command: ASCII command string (without CR)
-
-        Returns:
-            True if sent successfully
-        """
+        """Send a command to the laser."""
         if not self.is_connected or not self.serial:
             logger.error("Not connected to laser")
             return False
@@ -164,15 +142,7 @@ class HeliosLaser:
             return None
 
     def set_frequency_hz(self, frequency: int) -> bool:
-        """
-        Set laser pulse frequency in Hz.
-
-        Args:
-            frequency: Frequency in Hz (16700 - 125000)
-
-        Returns:
-            True if successful
-        """
+        """Set laser pulse frequency in Hz."""
         if not (16700 <= frequency <= 125000):
             logger.error(f"Frequency {frequency} Hz out of range (16700-125000)")
             return False
@@ -189,15 +159,7 @@ class HeliosLaser:
         return self._send_command(command)
 
     def set_current_ma(self, current: int) -> bool:
-        """
-        Set pump diode current in mA.
-
-        Args:
-            current: Current in mA (0 - 2000 for this model)
-
-        Returns:
-            True if successful
-        """
+        """Set pump diode current in mA."""
         if not (0 <= current <= 2000):
             logger.error(f"Current {current} mA out of range (0-2000)")
             return False
@@ -206,28 +168,12 @@ class HeliosLaser:
         return self._send_command(command)
 
     def set_pulse_mode(self, mode: PulseMode) -> bool:
-        """
-        Set pulse mode.
-
-        Args:
-            mode: PulseMode enumeration value
-
-        Returns:
-            True if successful
-        """
+        """Set pulse mode."""
         command = f"LDG {mode.value}"
         return self._send_command(command)
 
     def set_laser_enable(self, enable: bool) -> bool:
-        """
-        Enable or disable laser emission.
-
-        Args:
-            enable: True to enable, False to disable
-
-        Returns:
-            True if successful
-        """
+        """Enable or disable laser emission."""
         command = f"LDO {1 if enable else 0}"
         success = self._send_command(command)
 
@@ -329,15 +275,7 @@ class HeliosLaser:
             return None
 
     def set_remote_enable(self, enable: bool) -> bool:
-        """
-        Set the remote enable state (LRE - utility connector pin 8).
-
-        Args:
-            enable: True to activate remote enable, False to deactivate
-
-        Returns:
-            True if successful
-        """
+        """Set the remote enable state (LRE - utility connector pin 8)."""
         command = f"LRE {1 if enable else 0}"
         return self._send_command(command)