chore: sync workflow templates from Workflows repo (#62)

Automated sync from stranske/Workflows
Template hash: 69bf45f7ea5a

Changes synced from sync-manifest.yml

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: stranske

.github/scripts/decode_raw_input.py

@@ -18,9 +18,7 @@
 
 def _parse_args() -> argparse.Namespace:
     parser = argparse.ArgumentParser(description="Decode or normalize topic input")
-    parser.add_argument(
-        "--passthrough", action="store_true", help="Read plain text from --in file"
-    )
+    parser.add_argument("--passthrough", action="store_true", help="Read plain text from --in file")
     parser.add_argument("--in", dest="in_file", help="Input file for passthrough mode")
     parser.add_argument(
         "--source",
@@ -33,9 +31,7 @@ def _parse_args() -> argparse.Namespace:
 def main() -> None:
     args = _parse_args()
     text: str = ""
-    source_used = args.source_tag or (
-        "passthrough" if args.passthrough else "raw_input"
-    )
+    source_used = args.source_tag or ("passthrough" if args.passthrough else "raw_input")
     if args.passthrough:
         if not args.in_file:
             return
@@ -118,9 +114,7 @@ def apply_section_headers(s: str) -> str:
         rebuilt = s
         for m in markers:
             # replace occurrences not already preceded by newline
-            rebuilt = re.sub(
-                rf"(?<!\n){re.escape(m)}", "\n" + m.strip() + "\n", rebuilt
-            )
+            rebuilt = re.sub(rf"(?<!\n){re.escape(m)}", "\n" + m.strip() + "\n", rebuilt)
         if rebuilt != s:
             applied.append("sections")
         return rebuilt
@@ -170,9 +164,7 @@ def extract_enumerators(s: str) -> tuple[list[str], list[str]]:
     if text.strip():
         OUT_FILE.write_text(text + "\n", encoding="utf-8")
     # Always write diagnostics when debug artifact collection might happen
-    Path("decode_debug.json").write_text(
-        json.dumps(diagnostics, indent=2), encoding="utf-8"
-    )
+    Path("decode_debug.json").write_text(json.dumps(diagnostics, indent=2), encoding="utf-8")
 
 
 if __name__ == "__main__":

.github/scripts/parse_chatgpt_topics.py

@@ -25,9 +25,7 @@
 def _load_text() -> str:
     try:
         text = INPUT_PATH.read_text(encoding="utf-8").strip()
-    except (
-        FileNotFoundError
-    ) as exc:  # pragma: no cover - guardrail for workflow execution
+    except FileNotFoundError as exc:  # pragma: no cover - guardrail for workflow execution
         raise SystemExit("No input.txt found to parse.") from exc
     if not text:
         raise SystemExit("No topic content provided.")
@@ -46,9 +44,7 @@ def _split_numbered_items(text: str) -> list[dict[str, str | list[str] | bool]]:
     Each returned item dict includes:
       title, lines, enumerator, continuity_break (bool)
     """
-    pattern = re.compile(
-        r"^\s*(?P<enum>(?:\d+|[A-Za-z]\d+|[A-Za-z]))[\).:\-]\s+(?P<title>.+)$"
-    )
+    pattern = re.compile(r"^\s*(?P<enum>(?:\d+|[A-Za-z]\d+|[A-Za-z]))[\).:\-]\s+(?P<title>.+)$")
     items: list[dict[str, str | list[str] | bool]] = []
     current: dict[str, str | list[str] | bool] | None = None
     style: str | None = None  # 'numeric' | 'alpha' | 'alphanum'
@@ -174,9 +170,7 @@ def _join_section(lines: list[str]) -> str:
     return "\n".join(lines).strip()
 
 
-def parse_text(
-    text: str, *, allow_single_fallback: bool = False
-) -> list[dict[str, object]]:
+def parse_text(text: str, *, allow_single_fallback: bool = False) -> list[dict[str, object]]:
     """Parse raw *text* into topic dictionaries.
 
     Parameters

scripts/ci_coverage_delta.py

@@ -54,12 +54,7 @@ def _build_payload(
     *,
     fail_on_drop: bool,
 ) -> tuple[dict[str, Any], bool]:
-    timestamp = (
-        _dt.datetime.now(_dt.UTC)
-        .replace(microsecond=0)
-        .isoformat()
-        .replace("+00:00", "Z")
-    )
+    timestamp = _dt.datetime.now(_dt.UTC).replace(microsecond=0).isoformat().replace("+00:00", "Z")
     drop = max(0.0, baseline - current) if baseline > 0 else 0.0
     delta = current - baseline
     status: str
@@ -94,9 +89,7 @@ def main() -> int:
     baseline = _parse_float(
         os.environ.get("BASELINE_COVERAGE"), "BASELINE_COVERAGE", _DEFAULT_BASELINE
     )
-    alert_drop = _parse_float(
-        os.environ.get("ALERT_DROP"), "ALERT_DROP", _DEFAULT_ALERT_DROP
-    )
+    alert_drop = _parse_float(os.environ.get("ALERT_DROP"), "ALERT_DROP", _DEFAULT_ALERT_DROP)
     fail_on_drop = _truthy(os.environ.get("FAIL_ON_DROP"))
 
     try:
@@ -105,13 +98,9 @@ def main() -> int:
         print(str(exc), file=sys.stderr)
         return 1
 
-    payload, should_fail = _build_payload(
-        current, baseline, alert_drop, fail_on_drop=fail_on_drop
-    )
+    payload, should_fail = _build_payload(current, baseline, alert_drop, fail_on_drop=fail_on_drop)
 
-    output_path.write_text(
-        json.dumps(payload, indent=2, sort_keys=True) + "\n", encoding="utf-8"
-    )
+    output_path.write_text(json.dumps(payload, indent=2, sort_keys=True) + "\n", encoding="utf-8")
     print(f"Coverage delta written to {output_path}")
 
     return 1 if should_fail else 0

scripts/ci_history.py

@@ -54,12 +54,7 @@ def _build_history_record(
     metrics_path: Path,
     metrics_from_file: bool,
 ) -> dict[str, Any]:
-    timestamp = (
-        _dt.datetime.now(_dt.UTC)
-        .replace(microsecond=0)
-        .isoformat()
-        .replace("+00:00", "Z")
-    )
+    timestamp = _dt.datetime.now(_dt.UTC).replace(microsecond=0).isoformat().replace("+00:00", "Z")
     summary = metrics.get("summary", {})
     failures = metrics.get("failures", [])
 
@@ -85,12 +80,7 @@ def _build_history_record(
 
 
 def _build_classification_payload(metrics: dict[str, Any]) -> dict[str, Any]:
-    timestamp = (
-        _dt.datetime.now(_dt.UTC)
-        .replace(microsecond=0)
-        .isoformat()
-        .replace("+00:00", "Z")
-    )
+    timestamp = _dt.datetime.now(_dt.UTC).replace(microsecond=0).isoformat().replace("+00:00", "Z")
     failures = metrics.get("failures", []) or []
     counts = Counter(entry.get("status", "unknown") for entry in failures)
     payload: dict[str, Any] = {
@@ -119,9 +109,7 @@ def main() -> int:
     if classification_env is None:
         classification_env = os.environ.get("ENABLE_CLASSIFICATION_FLAG")
     classification_flag = _truthy(classification_env)
-    classification_out = Path(
-        os.environ.get("CLASSIFICATION_OUT", _DEFAULT_CLASSIFICATION)
-    )
+    classification_out = Path(os.environ.get("CLASSIFICATION_OUT", _DEFAULT_CLASSIFICATION))
 
     if not junit_path.is_file():
         print(f"JUnit report not found: {junit_path}", file=sys.stderr)

scripts/ci_metrics.py

@@ -205,10 +205,7 @@ def build_metrics(
 
     payload: dict[str, Any] = {
         "generated_at": (
-            _dt.datetime.now(_dt.UTC)
-            .replace(microsecond=0)
-            .isoformat()
-            .replace("+00:00", "Z")
+            _dt.datetime.now(_dt.UTC).replace(microsecond=0).isoformat().replace("+00:00", "Z")
         ),
         "junit_path": str(junit_path),
         "summary": summary,
@@ -226,19 +223,15 @@ def main() -> int:
     junit_path = Path(os.environ.get("JUNIT_PATH", _DEFAULT_JUNIT))
     output_path = Path(os.environ.get("OUTPUT_PATH", _DEFAULT_OUTPUT))
     top_n = _parse_int(os.environ.get("TOP_N"), "TOP_N", _DEFAULT_TOP_N)
-    min_seconds = _parse_float(
-        os.environ.get("MIN_SECONDS"), "MIN_SECONDS", _DEFAULT_MIN_SECONDS
-    )
+    min_seconds = _parse_float(os.environ.get("MIN_SECONDS"), "MIN_SECONDS", _DEFAULT_MIN_SECONDS)
 
     try:
         payload = build_metrics(junit_path, top_n=top_n, min_seconds=min_seconds)
     except FileNotFoundError as exc:
         print(str(exc), file=sys.stderr)
         return 1
 
-    output_path.write_text(
-        json.dumps(payload, indent=2, sort_keys=True) + "\n", encoding="utf-8"
-    )
+    output_path.write_text(json.dumps(payload, indent=2, sort_keys=True) + "\n", encoding="utf-8")
     print(f"Metrics written to {output_path}")
     return 0
 

scripts/sync_dev_dependencies.py

@@ -131,9 +131,7 @@ def find_project_section_end(content: str) -> int | None:
     return len(content)
 
 
-def create_dev_dependencies_section(
-    pins: dict[str, str], use_exact_pins: bool = True
-) -> str:
+def create_dev_dependencies_section(pins: dict[str, str], use_exact_pins: bool = True) -> str:
     """Create a new dev dependencies section with core tools."""
     op = "==" if use_exact_pins else ">="
     deps = []
@@ -158,9 +156,7 @@ def extract_dependencies(section: str) -> list[tuple[str, str, str]]:
     deps = []
     # Match patterns like "package>=1.0.0" or "package==1.0.0" or just "package"
     # Be precise: package name followed by optional version specifier
-    pattern = re.compile(
-        r'"([a-zA-Z0-9_-]+)(?:(>=|==|~=|>|<|<=|!=)([^"\[\]]+))?(?:\[.*?\])?"'
-    )
+    pattern = re.compile(r'"([a-zA-Z0-9_-]+)(?:(>=|==|~=|>|<|<=|!=)([^"\[\]]+))?(?:\[.*?\])?"')
 
     for match in pattern.finditer(section):
         package = match.group(1)
@@ -240,20 +236,12 @@ def sync_pyproject(
         opt_deps_pos = find_optional_dependencies_section(content)
         if opt_deps_pos is not None:
             # Add after [project.optional-dependencies] header
-            content = (
-                content[:opt_deps_pos]
-                + "\n"
-                + new_section
-                + "\n"
-                + content[opt_deps_pos:]
-            )
+            content = content[:opt_deps_pos] + "\n" + new_section + "\n" + content[opt_deps_pos:]
         else:
             # Need to add [project.optional-dependencies] section
             insert_pos = find_project_section_end(content)
             if insert_pos is None:
-                return [], [
-                    "Could not find [project] section to add optional-dependencies"
-                ]
+                return [], ["Could not find [project] section to add optional-dependencies"]
 
             section_to_add = "\n[project.optional-dependencies]\n" + new_section + "\n"
             content = content[:insert_pos] + section_to_add + content[insert_pos:]

scripts/sync_test_dependencies.py

@@ -211,9 +211,7 @@ def _read_local_modules() -> set[str]:
 
 def get_project_modules() -> set[str]:
     """Return the full set of project modules (static + dynamically detected + local)."""
-    return (
-        _BASE_PROJECT_MODULES | _detect_local_project_modules() | _read_local_modules()
-    )
+    return _BASE_PROJECT_MODULES | _detect_local_project_modules() | _read_local_modules()
 
 
 # For backward compatibility - will be populated on first use
@@ -366,9 +364,7 @@ def add_dependencies_to_pyproject(missing: set[str], fix: bool = False) -> bool:
         dev_group.multiline(True)
         optional[DEV_EXTRA] = dev_group
 
-    existing_normalised = {
-        _normalise_package_name(str(item).split("[")[0]) for item in dev_group
-    }
+    existing_normalised = {_normalise_package_name(str(item).split("[")[0]) for item in dev_group}
 
     added = False
     for package in sorted(missing):
@@ -387,9 +383,7 @@ def add_dependencies_to_pyproject(missing: set[str], fix: bool = False) -> bool:
 
 def main(argv: list[str] | None = None) -> int:
     """Main entry point."""
-    parser = argparse.ArgumentParser(
-        description="Sync test dependencies to pyproject.toml"
-    )
+    parser = argparse.ArgumentParser(description="Sync test dependencies to pyproject.toml")
     parser.add_argument(
         "--fix",
         action="store_true",

tools/coverage_trend.py

@@ -93,27 +93,15 @@ def main(args: list[str] | None = None) -> int:
     parser.add_argument("--coverage-xml", type=Path, help="Path to coverage.xml")
     parser.add_argument("--coverage-json", type=Path, help="Path to coverage.json")
     parser.add_argument("--baseline", type=Path, help="Path to baseline JSON")
-    parser.add_argument(
-        "--summary-path", type=Path, help="Path to output summary markdown"
-    )
+    parser.add_argument("--summary-path", type=Path, help="Path to output summary markdown")
     parser.add_argument("--job-summary", type=Path, help="Path to GITHUB_STEP_SUMMARY")
-    parser.add_argument(
-        "--artifact-path", type=Path, help="Path to output trend artifact"
-    )
+    parser.add_argument("--artifact-path", type=Path, help="Path to output trend artifact")
     parser.add_argument("--github-output", type=Path, help="Path to write env file")
+    parser.add_argument("--minimum", type=float, default=70.0, help="Minimum coverage threshold")
+    parser.add_argument("--hotspot-limit", type=int, default=15, help="Max hotspot files to show")
+    parser.add_argument("--low-threshold", type=float, default=50.0, help="Low coverage threshold")
     parser.add_argument(
-        "--minimum", type=float, default=70.0, help="Minimum coverage threshold"
-    )
-    parser.add_argument(
-        "--hotspot-limit", type=int, default=15, help="Max hotspot files to show"
-    )
-    parser.add_argument(
-        "--low-threshold", type=float, default=50.0, help="Low coverage threshold"
-    )
-    parser.add_argument(
-        "--soft",
-        action="store_true",
-        help="Soft gate mode - report only, always exit 0",
+        "--soft", action="store_true", help="Soft gate mode - report only, always exit 0"
     )
     parsed = parser.parse_args(args)
 
@@ -161,9 +149,7 @@ def main(args: list[str] | None = None) -> int:
             "hotspots": hotspots,
             "low_coverage_files": low_coverage,
         }
-        parsed.artifact_path.write_text(
-            json.dumps(artifact_data, indent=2), encoding="utf-8"
-        )
+        parsed.artifact_path.write_text(json.dumps(artifact_data, indent=2), encoding="utf-8")
 
     status = "✅ Pass" if passes_minimum else "❌ Below minimum"
     summary = f"""## Coverage Trend
@@ -180,9 +166,7 @@ def main(args: list[str] | None = None) -> int:
 
     # Add hotspot tables if we have coverage data
     if hotspots:
-        summary += _format_hotspot_table(
-            hotspots, "Top Coverage Hotspots (lowest coverage)"
-        )
+        summary += _format_hotspot_table(hotspots, "Top Coverage Hotspots (lowest coverage)")
 
     if low_coverage:
         summary += _format_hotspot_table(