chore: optimize CI to decouple lint from build and skip unnecessary jobs (#214)

* chore: optimize CI to decouple lint from
  build and skip unnecessary jobs

- Added a new input `run_lint_only` to the CI workflow to handle documentation-only changes.
- Updated the change detection logic to set `run_lint_only` when no service-impacting changes are detected.
- Modified the CI configuration to skip builds and tests when only documentation changes are present, improving efficiency.
- Enhanced the output summaries to include documentation change detection results.

* chore: refine CI workflow by removing redundant documentation path

- Removed the redundant 'docs/**/*.md' inclusion from the CI change detection configuration, streamlining the documentation linting process.

* chore: update CI workflow to trigger on main branch pushes

- Modified the CI configuration to run on pushes to the main branch, enhancing the workflow's responsiveness to changes in the primary development branch.

* chore: consolidate Tauri E2E test workflows into a single reusable configuration

- Introduced a new reusable workflow for Tauri E2E tests that encompasses all providers (official, embedded, CrabNebula), streamlining the CI process.
- Removed individual workflows for CrabNebula and embedded providers to reduce redundancy and improve maintainability.
- Updated the main CI configuration to utilize the new consolidated workflow, enhancing efficiency by reducing the number of runners required for testing.

* chore: update CI workflow to improve concurrency handling

- Removed tag trigger from the CI configuration to simplify event handling.
- Adjusted concurrency cancellation logic to only cancel in-progress jobs for non-pull request events, enhancing workflow efficiency.

* chore: update CI workflow descriptions for clarity

- Revised the description for the `run_lint_only` input to specify that it applies when no service-affecting changes are detected.
- Updated the summary output to reflect the new description, enhancing clarity in the CI process.

* refactor: streamline CI workflow result handling

- Introduced helper functions to format test results and check outcomes for providers in the CI workflow, improving code readability and maintainability.
- Consolidated result logging for official, embedded, and CrabNebula providers to reduce redundancy and enhance clarity in the output summaries.

* fix: ensure cleanup commands in CI workflows handle errors gracefully

- Updated PowerShell commands in the CI workflow to append '|| true', allowing the cleanup process to continue even if the specified processes are not found, enhancing robustness in both Windows and non-Windows environments.

* test(e2e): enhance Tauri E2E logging configuration

- Updated the logging exclusion list in the Tauri E2E configuration to include the new logging.tauri-driver.spec.ts file.
- Refactored logging directory retrieval in embedded and tauri-driver specs to utilize a new helper function for improved log directory naming based on the driver provider.

Author: goosewobbler

.github/workflows/_ci-detect-changes.reusable.yml

@@ -21,6 +21,9 @@ on:
       has_shared_changes:
         description: 'Whether shared packages changed (affects both services)'
         value: ${{ jobs.detect.outputs.has_shared_changes }}
+      run_lint_only:
+        description: 'Whether to run only lint (no service-affecting changes detected)'
+        value: ${{ jobs.detect.outputs.run_lint_only }}
 
 jobs:
   detect:
@@ -30,6 +33,7 @@ jobs:
       run_electron: ${{ steps.determine.outputs.run_electron || 'false' }}
       run_tauri: ${{ steps.determine.outputs.run_tauri || 'false' }}
       has_shared_changes: ${{ steps.determine.outputs.has_shared_changes || 'false' }}
+      run_lint_only: ${{ steps.determine.outputs.run_lint_only || 'false' }}
 
     steps:
       - name: Checkout Repository
@@ -42,6 +46,10 @@ jobs:
         uses: dorny/paths-filter@v4
         with:
           filters: |
+            # Documentation only (triggers lint only)
+            docs:
+              - '**/*.md'
+
             # Electron service packages
             electron_service:
               - 'packages/electron-service/**'
@@ -104,6 +112,7 @@ jobs:
           fi
 
           echo "::notice::Checking paths-filter outputs..."
+          echo "docs=${{ steps.changes.outputs.docs }}"
           echo "electron_service=${{ steps.changes.outputs.electron_service }}"
           echo "tauri_service=${{ steps.changes.outputs.tauri_service }}"
           echo "shared=${{ steps.changes.outputs.shared }}"
@@ -113,6 +122,7 @@ jobs:
           echo "fixtures_tauri=${{ steps.changes.outputs.fixtures_tauri }}"
           echo "infra=${{ steps.changes.outputs.infra }}"
 
+          DOCS=${{ steps.changes.outputs.docs }}
           ELECTRON=${{ steps.changes.outputs.electron_service }}
           TAURI=${{ steps.changes.outputs.tauri_service }}
           SHARED=${{ steps.changes.outputs.shared }}
@@ -134,15 +144,24 @@ jobs:
             RUN_TAURI="false"
           fi
 
+          # Lint-only mode when no service-impacting changes detected
+          # Covers docs-only PRs, config-only edits outside infra, etc.
+          RUN_LINT_ONLY="false"
+          if [ "$RUN_ELECTRON" = "false" ] && [ "$RUN_TAURI" = "false" ]; then
+            RUN_LINT_ONLY="true"
+          fi
+
           echo "run_electron=$RUN_ELECTRON" >> $GITHUB_OUTPUT
           echo "run_tauri=$RUN_TAURI" >> $GITHUB_OUTPUT
           echo "has_shared_changes=$SHARED" >> $GITHUB_OUTPUT
+          echo "run_lint_only=$RUN_LINT_ONLY" >> $GITHUB_OUTPUT
 
           # Create summary for GitHub Step Summary (appears in Actions Summary page)
           echo "## Change Detection Summary" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
           echo "| Category | Changed |" >> $GITHUB_STEP_SUMMARY
           echo "|----------|---------|" >> $GITHUB_STEP_SUMMARY
+          echo "| Documentation | $DOCS |" >> $GITHUB_STEP_SUMMARY
           echo "| Electron service | $ELECTRON |" >> $GITHUB_STEP_SUMMARY
           echo "| Tauri service | $TAURI |" >> $GITHUB_STEP_SUMMARY
           echo "| Shared packages | $SHARED |" >> $GITHUB_STEP_SUMMARY
@@ -155,14 +174,17 @@ jobs:
           echo "### Decisions" >> $GITHUB_STEP_SUMMARY
           echo "- **Run Electron**: $RUN_ELECTRON" >> $GITHUB_STEP_SUMMARY
           echo "- **Run Tauri**: $RUN_TAURI" >> $GITHUB_STEP_SUMMARY
+          echo "- **Lint only (no service changes)**: $RUN_LINT_ONLY" >> $GITHUB_STEP_SUMMARY
           echo "" >> $GITHUB_STEP_SUMMARY
           echo "### Outputs" >> $GITHUB_STEP_SUMMARY
           echo "- \`run_electron\`: $RUN_ELECTRON" >> $GITHUB_STEP_SUMMARY
           echo "- \`run_tauri\`: $RUN_TAURI" >> $GITHUB_STEP_SUMMARY
           echo "- \`has_shared_changes\`: $SHARED" >> $GITHUB_STEP_SUMMARY
+          echo "- \`run_lint_only\`: $RUN_LINT_ONLY" >> $GITHUB_STEP_SUMMARY
 
           # Also print to logs for debugging
           echo "Change Detection Summary:"
+          echo "  Documentation: $DOCS"
           echo "  Electron service: $ELECTRON"
           echo "  Tauri service: $TAURI"
           echo "  Shared packages: $SHARED"
@@ -174,3 +196,4 @@ jobs:
           echo ""
           echo "  Run Electron: $RUN_ELECTRON"
           echo "  Run Tauri: $RUN_TAURI"
+          echo "  Run lint only: $RUN_LINT_ONLY"