Improve release error handling and keep failures non-crashing

- catch subprocess command failures in release main flow
- print concise fail messages with command and exit code
- preserve non zero exit status while avoiding Python traceback noise - 2026-03-03 08:07:50

Author: mgarcia01752

docs/visual-previews/MultiCapture/ChannelEstimation/Ofdm-ChannelEstimation-Analysis-Min-Avg-Max.html

@@ -574,17 +574,23 @@ pm.visualizer.set(template, constructVisualizerPayload());
 
 ````json
 {
+    "system_description": {
+        "HW_REV": "1.0",
+        "VENDOR": "LANCity",
+        "BOOTR": "NONE",
+        "SW_REV": "1.0.0",
+        "MODEL": "LCPET-3"
+    },
     "status": 0,
     "message": "Analysis MIN_AVG_MAX completed for group 9d9d1827a80042ff",
     "device": {
-        "mac_address": "b0:f5:30:83:69:c0",
+        "mac_address": "aa:bb:cc:dd:ee:ff",
         "system_description": {
-            "HW_REV": "0B",
-            "VENDOR": "Hitron Technologies",
-            "BOOTR": "2022.01-MXL-v-4.0.369",
-            "SW_REV": "8.5.0.0.1b4",
-            "MODEL": "CGNDP4",
-            "is_empty": false
+            "HW_REV": "1.0",
+            "VENDOR": "LANCity",
+            "BOOTR": "NONE",
+            "SW_REV": "1.0.0",
+            "MODEL": "LCPET-3"
         }
     },
     "data": {

docs/visual/MultiCapture/ChannelEstimation/Ofdm-ChannelEstimation-Analysis-Min-Avg-Max.md

@@ -27,6 +27,10 @@ def run(cmd: list[str], check: bool = True) -> subprocess.CompletedProcess[str]:
     return result
 
 
+def format_cmd(cmd: list[str]) -> str:
+    return " ".join(cmd)
+
+
 def tag_exists(tag: str) -> bool:
     result = run(["git", "rev-parse", "-q", "--verify", f"refs/tags/{tag}"], check=False)
     return result.returncode == 0
@@ -212,15 +216,20 @@ def main() -> None:
     ensure_branch_allowed()
     ensure_clean_worktree()
 
-    if not args.skip_checks:
-        run_quality_gates(root)
+    try:
+        if not args.skip_checks:
+            run_quality_gates(root)
 
-    release_version = resolve_release_version(root, args.version)
-    print(f"Selected release version: {release_version}")
+        release_version = resolve_release_version(root, args.version)
+        print(f"Selected release version: {release_version}")
 
-    bump_version_files(root, release_version)
-    create_release_commit_and_tag(release_version, not args.no_push)
-    print(f"Release {release_version} complete.")
+        bump_version_files(root, release_version)
+        create_release_commit_and_tag(release_version, not args.no_push)
+        print(f"Release {release_version} complete.")
+    except subprocess.CalledProcessError as exc:
+        print(f"[fail] command failed with exit code {exc.returncode}: {format_cmd(exc.cmd)}")
+        print("[fail] release aborted")
+        raise SystemExit(exc.returncode)
 
 
 if __name__ == "__main__":

tools/release/release.py

@@ -1,15 +1,21 @@
 {
+    "system_description": {
+        "HW_REV": "1.0",
+        "VENDOR": "LANCity",
+        "BOOTR": "NONE",
+        "SW_REV": "1.0.0",
+        "MODEL": "LCPET-3"
+    },
     "status": 0,
     "message": "Analysis MIN_AVG_MAX completed for group 9d9d1827a80042ff",
     "device": {
-        "mac_address": "b0:f5:30:83:69:c0",
+        "mac_address": "aa:bb:cc:dd:ee:ff",
         "system_description": {
-            "HW_REV": "0B",
-            "VENDOR": "Hitron Technologies",
-            "BOOTR": "2022.01-MXL-v-4.0.369",
-            "SW_REV": "8.5.0.0.1b4",
-            "MODEL": "CGNDP4",
-            "is_empty": false
+            "HW_REV": "1.0",
+            "VENDOR": "LANCity",
+            "BOOTR": "NONE",
+            "SW_REV": "1.0.0",
+            "MODEL": "LCPET-3"
         }
     },
     "data": {
@@ -152072,4 +152078,4 @@
             }
         ]
     }
-}
+}