[cursor]

Risky behavior now covered

• is_kotor_install_dir across three shared entry points (diff_tool/cli_utils, tools/patching, tslpatcher/diff/engine) after the Case-Aware Application merge (Case-aware application #151). These helpers gate install detection for diff, patching, and TSLPatcher workflows.
• ConfigReader.from_filepath case-insensitive INI path resolution on POSIX (mod directory / filename casing mismatches).
• _supports_live_progress CI/GitHub Actions guard for JSON export progress logging (prevents silent loss of percentage milestones in automation).

Test files added/updated

• Added: Libraries/PyKotor/tests/common/test_kotor_install_detection.py (15 parametrized cases across 3 detectors)
• Updated: Libraries/PyKotor/tests/tslpatcher/test_reader.py (1 case-mismatch from_filepath test)
• Updated: Libraries/PyKotor/tests/cli/test_json_commands.py (3 _supports_live_progress tests)

Why these tests materially reduce regression risk

Install detection false negatives on Linux (case-mismatched chitin.key or install folder names) would mis-route diff/patch/CLI flows to folder mode instead of installation mode. The new tests lock in the CaseAwarePath behavior introduced in #151 for all three duplicated detectors.

ConfigReader.from_filepath is the production path used when loading mod INIs from disk; a regression would break TSLPatcher mod loading on case-sensitive filesystems when users or tooling pass differently-cased paths.

The JSON export progress tests ensure CI/automation continues to receive log-visible percentage milestones rather than relying on TTY \r live updates that bypass structured logging.

Validation

QT_QPA_PLATFORM=offscreen uv run pytest --import-mode=importlib -m "not gui and not slow" --timeout=120 \
  tests/common/test_kotor_install_detection.py \
  tests/tslpatcher/test_reader.py::TestConfigReader::test_from_filepath_resolves_case_mismatched_ini_path \
  tests/cli/test_json_commands.py::test_supports_live_progress_*

19/19 passed on Linux (case-mismatch install/INI tests skipped on Windows by design).

  

[github-actions]

Message that will be displayed on users' first pull request

[github-actions]

🔨 Build Validation Summary

✅ Version Check: Passed

Tool Builds

⚠️ HoloPatcher: cancelled
⚠️ HoloPazaak: cancelled
⚠️ HolocronToolset: cancelled
⚠️ KotorDiff: cancelled
⚠️ KotorMCP: cancelled

---

🎉 All builds validated successfully! This PR is ready for merge.