Merge pull request #8 from ventura8/feature/v1.2.0

release: v1.2.0 – cross-platform Linux/macOS support + real E2E test …

Author: ventura8

.agents/skills/release-prep/SKILL.md

@@ -70,6 +70,56 @@ Create two release docs under `docs/releases/`:
 .\run_local_pipeline.ps1
 ```
 
+### 5.5. Author Commit Title and Detailed Description
+
+Before committing, write a **conventional commit** with:
+
+- **Title** (≤ 72 chars): `release: vX.Y.Z – <one-line summary of biggest change>`
+- **Detailed description**: multiline body covering:
+  - What changed (features, fixes, refactors)
+  - Cross-platform / CI/CD improvements
+  - Quality gate results (coverage %, linter grades)
+  - Breaking changes (if any) prefixed with `BREAKING CHANGE:`
+
+Template:
+
+```text
+release: vX.Y.Z – <summary>
+
+## What's new
+- ...
+
+## Cross-platform & CI
+- ...
+
+## Quality gates
+- Coverage: XX.X% (threshold ≥ 90%)
+- Linters: ✅ zero warnings
+- Type checkers: ✅ zero errors
+- Radon complexity: ✅ A-grade (CC ≤ 5); project complexity threshold: CC < 10
+
+## Breaking changes
+<!-- Choose one of the following and remove the other: -->
+- None
+<!-- OR (standalone footer, no list marker):
+BREAKING CHANGE: <description>
+
+Alternatively use the title notation: release!: vX.Y.Z – <summary>
+-->
+```
+
+Stage and commit with this message:
+
+```bash
+poetry check --lock
+git add pyproject.toml poetry.lock pytest.ini docs/ README.md AGENTS.md .agents/skills/ \
+  docker/ tests/ modules/ auto_subtitle.py install_dependencies.sh \
+  run_local_pipeline.ps1 run_local_pipeline.sh start.sh .dockerignore \
+  .github/workflows/ci.yml .github/workflows/release.yml
+git diff --cached
+git commit -m "release: vX.Y.Z – <summary>" -m "<detailed body>"
+```
+
 ### 6. Commit and Tag
 
 Prepare clear, descriptive commit messages summarising the release features,

.dockerignore

@@ -0,0 +1,15 @@
+.venv/
+.git/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+__pycache__/
+*.pyc
+tests/fixtures/temp*
+radon_report.txt
+coverage.xml
+coverage.json
+.coverage
+.env
+.env.*
+.ssh/

.github/workflows/ci.yml

@@ -24,7 +24,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6.3.0
         with:
-          python-version: "3.12.13"
+          python-version: "3.12"
           cache: "pip"
           cache-dependency-path: |
             pyproject.toml
@@ -65,7 +65,11 @@ jobs:
       - name: Run PowerShell Lint
         shell: pwsh
         run: |
-          $scriptPaths = @("./install_dependencies.ps1", "./run_local_pipeline.ps1")
+          $scriptPaths = @(
+            "./install_dependencies.ps1",
+            "./run_local_pipeline.ps1",
+            "./.github/scripts/Invoke-PowerShellLint.ps1"
+          )
           & ./.github/scripts/Invoke-PowerShellLint.ps1 -ScriptPaths $scriptPaths -MaxCyclomaticComplexity 9 -MaxNestingDepth 4
 
       - name: Run Markdown auto-delinter (mdformat)
@@ -92,6 +96,10 @@ jobs:
         run: |
           poetry run ruff check modules auto_subtitle.py tests
 
+      - name: Run Ruff format check
+        run: |
+          poetry run ruff format --check .
+
       - name: Run Flake8
         run: |
           poetry run flake8 modules auto_subtitle.py tests
@@ -122,7 +130,7 @@ jobs:
 
       - name: Run Radon Complexity (A-grade enforced)
         run: |
-          poetry run radon cc auto_subtitle.py modules tests/modules tests/orchestration -s -a | tee radon_report.txt
+          poetry run radon cc auto_subtitle.py modules tests -s -a | tee radon_report.txt
 
           {
             echo "## Radon Cyclomatic Complexity"
@@ -139,7 +147,7 @@ jobs:
 
       - name: Run Radon Maintainability Index (A-grade enforced)
         run: |
-          poetry run radon mi auto_subtitle.py modules tests/modules tests/orchestration -s | tee radon_mi_report.txt
+          poetry run radon mi auto_subtitle.py modules tests -s | tee radon_mi_report.txt
 
           {
             echo "## Radon Maintainability Index (A-grade enforced)"
@@ -156,7 +164,7 @@ jobs:
 
       - name: Run Radon Halstead Metrics (hal)
         run: |
-          poetry run radon hal auto_subtitle.py modules tests/modules tests/orchestration | tee radon_hal_report.txt
+          poetry run radon hal auto_subtitle.py modules tests | tee radon_hal_report.txt
 
           {
             echo "## Radon Halstead Metrics"
@@ -177,7 +185,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6.3.0
         with:
-          python-version: "3.12.13"
+          python-version: "3.12"
           cache: "pip"
           cache-dependency-path: |
             pyproject.toml
@@ -208,7 +216,7 @@ jobs:
 
       - name: Run Tests with Coverage
         run: |
-          poetry run pytest --cov=auto_subtitle --cov=modules --cov-branch --cov-report=xml --cov-report=json --cov-report=term --cov-fail-under=90 tests/
+          poetry run pytest -m "not e2e" --cov=auto_subtitle --cov=modules --cov-branch --cov-report=xml --cov-report=json --cov-report=term --cov-fail-under=90 tests/
 
       - name: Enforce Per-File Coverage >= 90%
         run: |
@@ -241,7 +249,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6.3.0
         with:
-          python-version: "3.12.13"
+          python-version: "3.12"
           cache: "pip"
           cache-dependency-path: |
             pyproject.toml
@@ -279,3 +287,67 @@ jobs:
         run: |
           poetry run python tests/tools/transform_metrics.py coverage.xml assets/coverage.svg
           cat coverage_summary.md >> $GITHUB_STEP_SUMMARY
+
+  e2e_real_dependencies:
+    name: "🚀 Real Dependencies E2E (${{ matrix.os }})"
+    needs: [static_analysis, technical_validation]
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v7.0.0
+        with:
+          persist-credentials: false
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.3.0
+        with:
+          python-version: "3.12"
+
+      - name: Install FFmpeg (macOS)
+        if: runner.os == 'macOS'
+        run: brew install ffmpeg
+        env:
+          HOMEBREW_NO_REQUIRE_TAP_TRUST: "1"
+
+      - name: Install FFmpeg (Linux)
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y ffmpeg
+
+      - name: Install FFmpeg (Windows)
+        if: runner.os == 'Windows'
+        run: choco install ffmpeg --no-progress -y
+        shell: pwsh
+
+      - name: Install Poetry
+        run: python -m pip install "poetry==${{ env.POETRY_VERSION }}"
+
+      - name: Configure Poetry In-Project Virtualenv
+        run: poetry config virtualenvs.in-project true
+
+      - name: Install Real ML & Test Dependencies (Linux)
+        if: runner.os == 'Linux'
+        run: poetry install -v --with ml,dev --no-root
+        env:
+          POETRY_REQUESTS_TIMEOUT: "300"
+
+      - name: Install E2E Test Dependencies (macOS/Windows)
+        if: runner.os != 'Linux'
+        run: poetry install -v --only main,dev --no-root
+
+      - name: Run Real Dependencies E2E Test Suite (Linux)
+        if: runner.os == 'Linux'
+        run: poetry run pytest -m e2e tests/e2e/test_real_pipeline.py -v
+
+      - name: Run Real Dependencies E2E Smoke Tests (macOS)
+        if: runner.os == 'macOS'
+        run: poetry run pytest -m e2e -k "not real_nllb_translator_cpu_execution" tests/e2e/test_real_pipeline.py -v
+
+      - name: Run Real Dependencies E2E Smoke Tests (Windows)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: poetry run pytest -m e2e -k "not real_nllb_translator_cpu_execution" tests/e2e/test_real_pipeline.py -v