IQ.Pilot Release Commit @ bec7652

iqpilot/iq_maps/vendor_mapd_installer.py

@@ -1,14 +1,6 @@
 #!/usr/bin/env python3
 """
 Copyright © IQ.Lvbs, apart of Project Teal Lvbs, All Rights Reserved, licensed under https://konn3kt.com/tos
-
-Verifies the vendored `mapd` routing binary authored by Jacob Pfeifer
-(github.com/pfeiferj/mapd), built from the gitlvb teal/mapd fork against
-teal/gomsgq. The only accepted binary is the checked-in one matching the pinned
-hash; nothing is ever downloaded at runtime. Jacob's stock release build embeds
-a 15-reader msgq header layout — on this fork (NUM_READERS=32) its registration
-writes land inside other processes' reader slots, so a wrong binary is
-quarantined rather than left where manager could start it.
 """
 import hashlib
 import os
@@ -29,7 +21,6 @@ QUARANTINE_PATH = VENDOR_MAPD_PATH + ".quarantined"
 
 
 def sha256_of_file(path: str) -> str:
-  """Hex SHA-256 digest of a file on disk."""
   digest = hashlib.sha256()
   with open(path, "rb") as handle:
     for block in iter(lambda: handle.read(1 << 20), b""):
@@ -50,14 +41,12 @@ class VendorMapdInstaller:
     return str(self._params.get(_VERSION_PARAM) or "")
 
   def verify(self) -> bool:
-    """True iff the on-disk binary matches the pinned hash; quarantines a wrong one."""
     expected = self._expected_hash()
     if not expected:
       cloudlog.error("iq_maps: pinned mapd hash missing, vendor binary cannot be verified")
       return False
 
     if not os.path.isfile(VENDOR_MAPD_PATH):
-      # the binary is a tracked file: the updater/bundle restores it
       self._say("Offline maps engine missing; it will be restored by the next update.")
       self._params.remove(_VERSION_PARAM)
       return False
@@ -77,8 +66,6 @@ class VendorMapdInstaller:
       self._say(f"Offline maps engine verified [{VENDOR_RELEASE_TAG}]")
       return True
 
-    # a foreign binary — e.g. a stock release download from the retired fetch
-    # path — must never run: quarantine it where manager can't start it
     cloudlog.error(f"iq_maps: vendor mapd hash {current[:12]} != pinned {expected[:12]}, quarantining")
     self._say("Offline maps engine failed verification; quarantined until the next update.")
     try: