refactor: Remove unused imports and add exception comments

Co-authored-by: jmiller-moko <230051081+jmiller-moko@users.noreply.github.com>

scripts/maintenance/release_version.py

@@ -27,13 +27,12 @@ NOTE: Updates CHANGELOG.md and optionally updates VERSION in files
 """
 
 import argparse
-import json
 import re
 import subprocess
 import sys
 from datetime import datetime
 from pathlib import Path
-from typing import List, Optional, Tuple
+from typing import List, Optional
 
 
 class VersionReleaser:

scripts/maintenance/update_changelog.py

@@ -27,10 +27,8 @@ NOTE: Follows Keep a Changelog format, supports Added/Changed/Deprecated/Removed
 """
 
 import argparse
-import os
 import re
 import sys
-from datetime import datetime
 from pathlib import Path
 from typing import List, Optional
 

scripts/maintenance/validate_file_headers.py

@@ -28,7 +28,6 @@ VERSION: 05.00.00
 BRIEF: Validate copyright headers and file information in repository files
 """
 
-import os
 import sys
 from pathlib import Path
 from typing import List, Tuple, Dict

scripts/validate/auto_detect_platform.py

@@ -31,14 +31,13 @@ Exit codes:
 import argparse
 import hashlib
 import json
-import os
 import pickle
 import sys
 import xml.etree.ElementTree as ET
-from dataclasses import dataclass, asdict
+from dataclasses import dataclass
 from enum import Enum
 from pathlib import Path
-from typing import Dict, List, Optional, Tuple
+from typing import Dict, List, Optional
 
 
 # Version
@@ -146,6 +145,7 @@ class DetectionCache:
             with open(cache_file, 'wb') as f:
                 pickle.dump(result, f)
         except (pickle.PickleError, OSError):
+            # Ignore cache write failures: cache is optional optimization
             pass
 
     def clear(self) -> None:
@@ -154,6 +154,7 @@ class DetectionCache:
             try:
                 cache_file.unlink()
             except OSError:
+                # Ignore failures to delete cache files: stale cache entries are non-critical
                 pass
 
 
@@ -228,7 +229,6 @@ class PlatformDetector:
         indicators: List[str] = []
         metadata: Dict[str, str] = {}
 
-        manifest_patterns = ["**/*.xml"]
         skip_dirs = {".git", "vendor", "node_modules", ".github"}
 
         for xml_file in self.repo_path.glob("**/*.xml"):

scripts/validate/validate_structure_v2.py

@@ -27,12 +27,11 @@ Exit codes:
 """
 
 import sys
-import os
 import argparse
 import xml.etree.ElementTree as ET
 import json
 from pathlib import Path
-from typing import List, Dict, Tuple, Optional, Any
+from typing import List, Dict, Optional, Any
 from dataclasses import dataclass
 from enum import Enum
 
@@ -113,6 +112,8 @@ class RepositoryStructureValidator:
                     elif content.startswith('<?xml') or content.startswith('<'):
                         return "xml"
             except Exception:
+                # Intentionally ignore read/parse errors; fall through to the generic
+                # "Unable to detect schema format" ValueError raised below.
                 pass
 
             # Unable to detect format