Sync from development - prepare for v0.5.0

jackify/backend/utils/cc_content_detector.py

@@ -0,0 +1,34 @@
+"""
+Detects Creation Club / Anniversary Edition content missing errors in engine output.
+"""
+
+import re
+from typing import Optional
+
+# Matches CC content file names: ccXXXsse001-name.bsa/esm/esl/esp, ccXXXfo4001-name.ba2, etc.
+# No leading \b — filenames often appear with a Data_ prefix (Data_ccbgssse019-...)
+# where _ is a word char and would prevent \b from matching.
+_CC_FILE_RE = re.compile(
+    r'cc[a-z]{2,8}\d{3,4}[-\w]*\.(?:bsa|esm|esl|esp|ba2)',
+    re.IGNORECASE
+)
+
+_ERROR_WORDS = frozenset((
+    'missing', 'required', 'failed', 'unable', 'cannot', 'error', 'not found',
+))
+
+
+def is_cc_content_error(line: str) -> bool:
+    """Return True if line indicates a missing CC/AE content file in an error context."""
+    if not line:
+        return False
+    normalized = line.strip().lower()
+    if not _CC_FILE_RE.search(normalized):
+        return False
+    return any(w in normalized for w in _ERROR_WORDS)
+
+
+def extract_cc_filename(line: str) -> Optional[str]:
+    """Return the CC filename from a line, or None if not found."""
+    m = _CC_FILE_RE.search(line)
+    return m.group(0) if m else None