snapdrift 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,43 @@
+# Changelog
+
+## Unreleased
+
+## 0.2.0 - 2026-04-08
+
+### Features
+
+- **Local CLI** (`snapdrift capture` / `snapdrift diff`) — run visual captures and diffs locally against a running app without GitHub Actions. Outputs land in `.snapdrift/` by default; all paths are overridable via flags. Exits non-zero when `diff.mode` enforces failure.
+- **Self-contained HTML diff report** — the drift artifact now includes a single `report.html` with baseline/current screenshots and diff images embedded as base64, viewable without any server.
+- **Custom viewport support** — route `viewport` now accepts an object `{ "width": number, "height": number }` in addition to the `"desktop"` and `"mobile"` presets.
+- **Parallel capture by viewport** — routes are now captured concurrently per viewport group, roughly halving capture time on multi-route configurations.
+- **Route ID sanitization** — route IDs are sanitised before use as filenames, preventing path-traversal sequences from escaping the screenshots directory.
+- **Capture retry logic** — failed route captures are retried once before being recorded as errors.
+- **Progress logging** — capture and comparison steps now emit per-route progress to stdout.
+
+### Fixes
+
+- HTML report image embedding now falls back correctly when a resolved image path is missing.
+- Custom viewport values are formatted correctly in PR comment reports and dimension-shift entries.
+- Viewport width/height are cast to numbers before comparison to prevent type-mismatch false positives.
+- Dimension shifts section in PR comment reports is auto-expanded by default.
+
+### Dependencies
+
+- `playwright` 1.58.2 → 1.59.1
+- `eslint` 9.x → 10.x, `@eslint/js` 9.x → 10.x
+- `typescript` 5.x → 6.x
+- `jest` 30.2.0 → 30.3.0
+- `actions/upload-artifact` v4 → v7
+
+### Infrastructure
+
+- Added npm publish workflow (`.github/workflows/publish.yml`) triggered on GitHub release, with provenance attestation.
+- Added `publishConfig` to `package.json` to make public access and registry explicit.
+
+## 0.1.0 - 2026-03-09
+
+- Prepared SnapDrift for the first public GitHub release under version `0.1.0`.
+- Fixed capture metadata to record actual full-page PNG dimensions so dimension shifts stay classified separately from comparison errors.
+- Standardized the public contract on SnapDrift-only config paths, environment variables, report markers, and artifact filenames.
+- Added Node 22 self-provisioning to the standalone actions that shell out to `node` or `npm`.
+- Updated README, contracts, and integration docs to reference public release tags, with commit SHA pinning as an optional hardening step.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 CodeSamplez
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,104 @@
+# SnapDrift
+
+![SnapDrift](assets/snapdrift-logo-banner.png)
+
+![CI](https://github.com/ranacseruet/snapdrift/actions/workflows/ci.yml/badge.svg)
+![Node](https://img.shields.io/badge/node-%3E%3D22-brightgreen)
+![License: MIT](https://img.shields.io/badge/license-MIT-blue)
+
+SnapDrift captures full-page application frames, compares them against a known baseline, and reports drift directly in GitHub Actions.
+
+SnapDrift is ready to integrate from public GitHub releases. Workflow examples below use the first public tag for readability; security-conscious consumers can pin the resolved commit SHA instead.
+
+## What SnapDrift handles
+
+- Baseline capture on `main`
+- Pull request drift detection against the latest successful baseline
+- Route scoping from changed files
+- PR report upserts
+- Drift enforcement through `diff.mode`
+
+You keep ownership of checkout, build, startup, readiness, and teardown. SnapDrift takes over once the app is reachable.
+
+## Quickstart
+
+**1. Add `.github/snapdrift.json` to your repo:**
+
+```json
+{
+  "baselineArtifactName": "my-app-snapdrift-baseline",
+  "workingDirectory": ".",
+  "baseUrl": "http://127.0.0.1:8080",
+  "resultsFile": "qa-artifacts/snapdrift/baseline/current/results.json",
+  "manifestFile": "qa-artifacts/snapdrift/baseline/current/manifest.json",
+  "screenshotsRoot": "qa-artifacts/snapdrift/baseline/current",
+  "routes": [
+    { "id": "home-desktop", "path": "/", "viewport": "desktop" },
+    { "id": "home-mobile", "path": "/", "viewport": "mobile" }
+  ],
+  "diff": { "threshold": 0.01, "mode": "report-only" }
+}
+```
+
+**2. Publish a baseline on push to `main`:**
+
+```yaml
+- name: SnapDrift Baseline
+  uses: ranacseruet/snapdrift/actions/baseline@v0.1.0
+  with:
+    repo-config-path: .github/snapdrift.json
+```
+
+**3. Run SnapDrift on pull requests:**
+
+```yaml
+- name: SnapDrift Report
+  uses: ranacseruet/snapdrift/actions/pr-diff@v0.1.0
+  with:
+    github-token: ${{ secrets.GITHUB_TOKEN }}
+    repo-config-path: .github/snapdrift.json
+```
+
+That is the full integration. See the [Integration Guide](docs/integration-guide.md) for workflow examples, permissions, compatibility notes, and advanced overrides.
+
+## Local CLI
+
+SnapDrift ships a `snapdrift` CLI for running captures and diffs locally against a running app — no GitHub Actions required. Use it during development to validate UI changes before pushing.
+
+```bash
+# Capture a baseline
+snapdrift capture
+
+# Compare against it after making UI changes
+snapdrift diff --open
+```
+
+See the [Local CLI guide](docs/local-cli.md) for installation, all flags, directory layout, and examples.
+
+## Drift modes
+
+Start with `report-only` while baselines settle. Move to `fail-on-changes` or stricter modes once the signal is stable.
+
+| Mode | Stops the run when |
+|------|--------------------|
+| `report-only` | Never |
+| `fail-on-changes` | Any capture exceeds threshold |
+| `fail-on-incomplete` | Captures are missing, dimensions shift, or comparison errors occur |
+| `strict` | Any drift signal or incomplete comparison appears |
+
+## Current constraints
+
+- Ubuntu runners only
+- Full-page capture only
+- Fixed viewport presets: `desktop` (1440×900) and `mobile` (390×844)
+- One global `diff.threshold`
+- Dimension shifts are reported separately from pixel drift
+
+## Docs
+
+- [Integration Guide](docs/integration-guide.md)
+- [Local CLI](docs/local-cli.md)
+- [Contracts](docs/contracts.md)
+- [Changelog](CHANGELOG.md)
+- [Contributing](CONTRIBUTING.md)
+- [License](LICENSE)

package/actions/baseline/action.yml

@@ -0,0 +1,142 @@
+name: SnapDrift Baseline
+description: Capture configured routes, stage a SnapDrift baseline, and upload it with the configured artifact name.
+
+inputs:
+  repo-config-path:
+    description: Path to the SnapDrift config file.
+    required: false
+    default: .github/snapdrift.json
+  route-ids:
+    description: Optional comma-separated route ids to capture.
+    required: false
+    default: ''
+  artifact-retention-days:
+    description: Retention period for the uploaded baseline artifact.
+    required: false
+    default: '30'
+  upload-artifact:
+    description: Whether to upload the staged baseline artifact.
+    required: false
+    default: 'true'
+
+outputs:
+  artifact-name:
+    description: Artifact name loaded from the SnapDrift config.
+    value: ${{ steps.config.outputs.artifact_name }}
+  bundle-dir:
+    description: Staged artifact bundle directory.
+    value: ${{ steps.stage.outputs.bundle_dir }}
+  results-file:
+    description: Absolute path to the generated baseline results file.
+    value: ${{ steps.capture.outputs.results_file }}
+  manifest-file:
+    description: Absolute path to the generated baseline manifest file.
+    value: ${{ steps.capture.outputs.manifest_file }}
+  screenshots-root:
+    description: Absolute path to the generated screenshots root.
+    value: ${{ steps.capture.outputs.screenshots_root }}
+  selected-route-ids:
+    description: Comma-separated route ids captured in this run.
+    value: ${{ steps.capture.outputs.selected_route_ids }}
+
+runs:
+  using: composite
+  steps:
+    - name: Set action root path
+      shell: bash
+      run: echo "ACTION_ROOT=$(cd "$GITHUB_ACTION_PATH/../.." && pwd)" >> "$GITHUB_ENV"
+
+    - name: Set up Node.js
+      uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+      with:
+        node-version: '22'
+
+    - id: config
+      shell: bash
+      env:
+        REPO_CONFIG_PATH: ${{ inputs.repo-config-path }}
+      run: |
+        node --input-type=module <<'EOF'
+        import fs from 'node:fs/promises';
+        import path from 'node:path';
+        import { pathToFileURL } from 'node:url';
+
+        const modulePath = path.resolve(process.env.ACTION_ROOT, 'lib/snapdrift-config.mjs');
+        const { loadSnapdriftConfig } = await import(pathToFileURL(modulePath));
+        const { config } = await loadSnapdriftConfig(process.env.REPO_CONFIG_PATH || undefined);
+
+        await fs.appendFile(process.env.GITHUB_OUTPUT, `artifact_name=${config.baselineArtifactName}\n`);
+        EOF
+
+    - name: Install shared action dependencies
+      shell: bash
+      run: npm ci --prefix "$ACTION_ROOT"
+
+    - name: Install Playwright Chromium
+      shell: bash
+      run: |
+        "$ACTION_ROOT/node_modules/.bin/playwright" install --with-deps chromium
+
+    - id: capture
+      shell: bash
+      env:
+        REPO_CONFIG_PATH: ${{ inputs.repo-config-path }}
+        ROUTE_IDS: ${{ inputs.route-ids }}
+      run: |
+        node --input-type=module <<'EOF'
+        import fs from 'node:fs/promises';
+        import path from 'node:path';
+        import { pathToFileURL } from 'node:url';
+
+        const captureModulePath = path.resolve(process.env.ACTION_ROOT, 'lib/capture-routes.mjs');
+        const configModulePath = path.resolve(process.env.ACTION_ROOT, 'lib/snapdrift-config.mjs');
+        const { runBaselineCapture } = await import(pathToFileURL(captureModulePath));
+        const { splitCommaList } = await import(pathToFileURL(configModulePath));
+
+        const result = await runBaselineCapture({
+          configPath: process.env.REPO_CONFIG_PATH || undefined,
+          routeIds: splitCommaList(process.env.ROUTE_IDS)
+        });
+
+        const outputs = [
+          `results_file=${result.resultsPath}`,
+          `manifest_file=${result.manifestPath}`,
+          `screenshots_root=${result.screenshotsRoot}`,
+          `selected_route_ids=${result.selectedRouteIds.join(',')}`
+        ].join('\n') + '\n';
+
+        await fs.appendFile(process.env.GITHUB_OUTPUT, outputs);
+        EOF
+
+    - id: stage
+      shell: bash
+      env:
+        RESULTS_PATH: ${{ steps.capture.outputs.results_file }}
+        MANIFEST_PATH: ${{ steps.capture.outputs.manifest_file }}
+        SCREENSHOTS_DIR: ${{ steps.capture.outputs.screenshots_root }}/screenshots
+      run: |
+        node --input-type=module <<'EOF'
+        import fs from 'node:fs/promises';
+        import path from 'node:path';
+        import { pathToFileURL } from 'node:url';
+
+        const modulePath = path.resolve(process.env.ACTION_ROOT, 'lib/stage-artifacts.mjs');
+        const { stageArtifacts } = await import(pathToFileURL(modulePath));
+
+        const result = await stageArtifacts({
+          artifactType: 'baseline',
+          resultsPath: process.env.RESULTS_PATH || undefined,
+          manifestPath: process.env.MANIFEST_PATH || undefined,
+          screenshotsDir: process.env.SCREENSHOTS_DIR || undefined
+        });
+
+        await fs.appendFile(process.env.GITHUB_OUTPUT, `bundle_dir=${result.bundleDir}\n`);
+        EOF
+
+    - if: inputs.upload-artifact == 'true'
+      uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4
+      with:
+        name: ${{ steps.config.outputs.artifact_name }}
+        retention-days: ${{ inputs.artifact-retention-days }}
+        if-no-files-found: warn
+        path: ${{ steps.stage.outputs.bundle_dir }}

package/actions/capture/action.yml

@@ -0,0 +1,78 @@
+name: SnapDrift Capture
+description: Capture configured SnapDrift routes and emit the standard results and manifest files.
+
+inputs:
+  repo-config-path:
+    description: Path to the SnapDrift config file.
+    required: false
+    default: .github/snapdrift.json
+  route-ids:
+    description: Optional comma-separated route ids to capture.
+    required: false
+    default: ''
+
+outputs:
+  results-file:
+    description: Absolute path to the generated baseline results file.
+    value: ${{ steps.capture.outputs.results_file }}
+  manifest-file:
+    description: Absolute path to the generated screenshot manifest file.
+    value: ${{ steps.capture.outputs.manifest_file }}
+  screenshots-root:
+    description: Absolute path to the generated screenshots root.
+    value: ${{ steps.capture.outputs.screenshots_root }}
+  selected-route-ids:
+    description: Comma-separated route ids captured in this run.
+    value: ${{ steps.capture.outputs.selected_route_ids }}
+
+runs:
+  using: composite
+  steps:
+    - name: Set action root path
+      shell: bash
+      run: echo "ACTION_ROOT=$(cd "$GITHUB_ACTION_PATH/../.." && pwd)" >> "$GITHUB_ENV"
+
+    - name: Set up Node.js
+      uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+      with:
+        node-version: '22'
+
+    - name: Install shared action dependencies
+      shell: bash
+      run: npm ci --prefix "$ACTION_ROOT"
+
+    - name: Install Playwright Chromium
+      shell: bash
+      run: |
+        "$ACTION_ROOT/node_modules/.bin/playwright" install --with-deps chromium
+
+    - id: capture
+      shell: bash
+      env:
+        REPO_CONFIG_PATH: ${{ inputs.repo-config-path }}
+        ROUTE_IDS: ${{ inputs.route-ids }}
+      run: |
+        node --input-type=module <<'EOF'
+        import fs from 'node:fs/promises';
+        import path from 'node:path';
+        import { pathToFileURL } from 'node:url';
+
+        const modulePath = path.resolve(process.env.ACTION_ROOT, 'lib/capture-routes.mjs');
+        const configModulePath = path.resolve(process.env.ACTION_ROOT, 'lib/snapdrift-config.mjs');
+        const { runBaselineCapture } = await import(pathToFileURL(modulePath));
+        const { splitCommaList } = await import(pathToFileURL(configModulePath));
+
+        const result = await runBaselineCapture({
+          configPath: process.env.REPO_CONFIG_PATH || undefined,
+          routeIds: splitCommaList(process.env.ROUTE_IDS)
+        });
+
+        const outputs = [
+          `results_file=${result.resultsPath}`,
+          `manifest_file=${result.manifestPath}`,
+          `screenshots_root=${result.screenshotsRoot}`,
+          `selected_route_ids=${result.selectedRouteIds.join(',')}`
+        ].join('\n') + '\n';
+
+        await fs.appendFile(process.env.GITHUB_OUTPUT, outputs);
+        EOF

package/actions/comment/action.yml

@@ -0,0 +1,104 @@
+name: SnapDrift Comment
+description: Upsert a PR comment with the SnapDrift report.
+
+inputs:
+  github-token:
+    description: Token used to update the pull request comment.
+    required: true
+  pr-number:
+    description: Pull request number to comment on.
+    required: false
+    default: ''
+  summary-path:
+    description: Path to the SnapDrift summary JSON.
+    required: true
+  run-url:
+    description: Workflow run URL to include in the comment.
+    required: false
+    default: ''
+  artifact-name:
+    description: Artifact label to include in the comment.
+    required: false
+    default: ''
+
+runs:
+  using: composite
+  steps:
+    - name: Set action root path
+      shell: bash
+      run: echo "ACTION_ROOT=$(cd "$GITHUB_ACTION_PATH/../.." && pwd)" >> "$GITHUB_ENV"
+
+    - uses: actions/github-script@f28e40c7f34bde8b3046d885e986cb6290c5673b # v7
+      env:
+        VISUAL_DIFF_SUMMARY_PATH: ${{ inputs.summary-path }}
+        VISUAL_DIFF_RUN_URL: ${{ inputs.run-url }}
+        VISUAL_DIFF_ARTIFACT_NAME: ${{ inputs.artifact-name }}
+        INPUT_PR_NUMBER: ${{ inputs.pr-number }}
+      with:
+        github-token: ${{ inputs.github-token }}
+        script: |
+          const fs = require('fs');
+          const path = require('path');
+          const { pathToFileURL } = require('url');
+
+          const summaryPath = process.env.VISUAL_DIFF_SUMMARY_PATH;
+          if (!fs.existsSync(summaryPath)) {
+            core.warning(`SnapDrift summary not found at ${summaryPath}`);
+            return;
+          }
+
+          const issueNumber = Number(process.env.INPUT_PR_NUMBER || context.payload.pull_request?.number || context.issue?.number || '');
+          if (!Number.isFinite(issueNumber) || issueNumber <= 0) {
+            core.warning('SnapDrift PR report skipped because no pull request number was available.');
+            return;
+          }
+
+          const modulePath = path.resolve(process.env.ACTION_ROOT, 'lib/pr-comment.mjs');
+          const { buildReportCommentBody, PR_COMMENT_MARKERS } = await import(pathToFileURL(modulePath));
+
+          const summary = JSON.parse(fs.readFileSync(summaryPath, 'utf8'));
+          const runUrl = process.env.VISUAL_DIFF_RUN_URL || `${process.env.GITHUB_SERVER_URL}/${process.env.GITHUB_REPOSITORY}/actions/runs/${process.env.GITHUB_RUN_ID}`;
+
+          const body = buildReportCommentBody(summary, {
+            artifactName: process.env.VISUAL_DIFF_ARTIFACT_NAME || '',
+            runUrl
+          });
+
+          const comments = await github.paginate(github.rest.issues.listComments, {
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            issue_number: issueNumber,
+            per_page: 100
+          });
+          const matchingComments = comments
+            .filter((comment) => comment.body && PR_COMMENT_MARKERS.some((marker) => comment.body.includes(marker)))
+            .sort((left, right) => {
+              const leftTime = new Date(left.updated_at || left.created_at).getTime();
+              const rightTime = new Date(right.updated_at || right.created_at).getTime();
+              return rightTime - leftTime;
+            });
+          const existing = matchingComments[0];
+
+          if (existing) {
+            await github.rest.issues.updateComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              comment_id: existing.id,
+              body
+            });
+          } else {
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: issueNumber,
+              body
+            });
+          }
+
+          for (const duplicate of matchingComments.slice(1)) {
+            await github.rest.issues.deleteComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              comment_id: duplicate.id
+            });
+          }

package/actions/compare/action.yml

@@ -0,0 +1,163 @@
+name: SnapDrift Compare
+description: Compare the current capture against a baseline and emit the SnapDrift report files.
+
+inputs:
+  repo-config-path:
+    description: Path to the SnapDrift config file.
+    required: false
+    default: .github/snapdrift.json
+  route-ids:
+    description: Optional comma-separated route ids to compare.
+    required: false
+    default: ''
+  baseline-results-path:
+    description: Absolute or workspace-relative path to the baseline results JSON.
+    required: true
+  baseline-manifest-path:
+    description: Absolute or workspace-relative path to the baseline screenshot manifest JSON.
+    required: true
+  current-results-path:
+    description: Absolute or workspace-relative path to the current results JSON.
+    required: false
+    default: ''
+  current-manifest-path:
+    description: Absolute or workspace-relative path to the current screenshot manifest JSON.
+    required: false
+    default: ''
+  baseline-run-dir:
+    description: Root directory that contains baseline screenshots.
+    required: true
+  current-run-dir:
+    description: Root directory that contains current screenshots.
+    required: false
+    default: ''
+  out-dir:
+    description: Directory where the SnapDrift report files should be written.
+    required: false
+    default: qa-artifacts/snapdrift/drift/current
+  summary-path:
+    description: Optional explicit path for the SnapDrift summary JSON file.
+    required: false
+    default: ''
+  markdown-path:
+    description: Optional explicit path for the SnapDrift summary markdown file.
+    required: false
+    default: ''
+  baseline-artifact-name:
+    description: Optional baseline artifact label for the summary.
+    required: false
+    default: ''
+  baseline-source-sha:
+    description: Optional baseline source SHA for the summary.
+    required: false
+    default: ''
+  enforce-outcome:
+    description: Whether to fail according to diff.mode after writing the summary.
+    required: false
+    default: 'false'
+
+outputs:
+  summary-path:
+    description: Absolute path to the generated summary JSON file.
+    value: ${{ steps.compare.outputs.summary_path }}
+  markdown-path:
+    description: Absolute path to the generated summary markdown file.
+    value: ${{ steps.compare.outputs.markdown_path }}
+  status:
+    description: Computed SnapDrift status.
+    value: ${{ steps.compare.outputs.status }}
+  changed-screenshots:
+    description: Number of changed screenshots.
+    value: ${{ steps.compare.outputs.changed_screenshots }}
+  matched-screenshots:
+    description: Number of matched screenshots.
+    value: ${{ steps.compare.outputs.matched_screenshots }}
+  missing-in-baseline:
+    description: Number of screenshots missing in the baseline.
+    value: ${{ steps.compare.outputs.missing_in_baseline }}
+  missing-in-current:
+    description: Number of screenshots missing in the current capture.
+    value: ${{ steps.compare.outputs.missing_in_current }}
+  errors-count:
+    description: Number of comparison errors.
+    value: ${{ steps.compare.outputs.errors_count }}
+
+runs:
+  using: composite
+  steps:
+    - name: Set action root path
+      shell: bash
+      run: echo "ACTION_ROOT=$(cd "$GITHUB_ACTION_PATH/../.." && pwd)" >> "$GITHUB_ENV"
+
+    - name: Set up Node.js
+      uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f # v6.3.0
+      with:
+        node-version: '22'
+
+    - name: Install shared action dependencies
+      shell: bash
+      run: npm ci --prefix "$ACTION_ROOT"
+
+    - id: compare
+      shell: bash
+      env:
+        REPO_CONFIG_PATH: ${{ inputs.repo-config-path }}
+        ROUTE_IDS: ${{ inputs.route-ids }}
+        BASELINE_RESULTS_PATH: ${{ inputs.baseline-results-path }}
+        BASELINE_MANIFEST_PATH: ${{ inputs.baseline-manifest-path }}
+        CURRENT_RESULTS_PATH: ${{ inputs.current-results-path }}
+        CURRENT_MANIFEST_PATH: ${{ inputs.current-manifest-path }}
+        BASELINE_RUN_DIR: ${{ inputs.baseline-run-dir }}
+        CURRENT_RUN_DIR: ${{ inputs.current-run-dir }}
+        OUT_DIR: ${{ inputs.out-dir }}
+        SUMMARY_PATH: ${{ inputs.summary-path }}
+        MARKDOWN_PATH: ${{ inputs.markdown-path }}
+        BASELINE_ARTIFACT_NAME: ${{ inputs.baseline-artifact-name }}
+        BASELINE_SOURCE_SHA: ${{ inputs.baseline-source-sha }}
+        ENFORCE_OUTCOME: ${{ inputs.enforce-outcome }}
+      run: |
+        node --input-type=module <<'EOF'
+        import fs from 'node:fs/promises';
+        import path from 'node:path';
+        import { pathToFileURL } from 'node:url';
+
+        const modulePath = path.resolve(process.env.ACTION_ROOT, 'lib/compare-results.mjs');
+        const configModulePath = path.resolve(process.env.ACTION_ROOT, 'lib/snapdrift-config.mjs');
+        const { runDriftCheckCli } = await import(pathToFileURL(modulePath));
+        const { splitCommaList } = await import(pathToFileURL(configModulePath));
+
+        const resolvedOutDir = path.resolve(process.env.OUT_DIR || 'qa-artifacts/snapdrift/drift/current');
+        const resolvedSummaryPath = path.resolve(process.env.SUMMARY_PATH || path.join(resolvedOutDir, 'summary.json'));
+        const resolvedMarkdownPath = path.resolve(process.env.MARKDOWN_PATH || path.join(resolvedOutDir, 'summary.md'));
+
+        await runDriftCheckCli({
+          configPath: process.env.REPO_CONFIG_PATH || undefined,
+          baselineResultsPath: process.env.BASELINE_RESULTS_PATH || undefined,
+          baselineManifestPath: process.env.BASELINE_MANIFEST_PATH || undefined,
+          currentResultsPath: process.env.CURRENT_RESULTS_PATH || undefined,
+          currentManifestPath: process.env.CURRENT_MANIFEST_PATH || undefined,
+          baselineRunDir: process.env.BASELINE_RUN_DIR || undefined,
+          currentRunDir: process.env.CURRENT_RUN_DIR || undefined,
+          outDir: resolvedOutDir,
+          summaryPath: resolvedSummaryPath,
+          markdownPath: resolvedMarkdownPath,
+          routeIds: splitCommaList(process.env.ROUTE_IDS),
+          baselineArtifactName: process.env.BASELINE_ARTIFACT_NAME || undefined,
+          baselineSourceSha: process.env.BASELINE_SOURCE_SHA || undefined,
+          enforceOutcome: process.env.ENFORCE_OUTCOME === 'true'
+        });
+
+        const summary = JSON.parse(await fs.readFile(resolvedSummaryPath, 'utf8'));
+        const outputs = [
+          `summary_path=${resolvedSummaryPath}`,
+          `markdown_path=${resolvedMarkdownPath}`,
+          `status=${summary.status || ''}`,
+          `changed_screenshots=${summary.changedScreenshots || 0}`,
+          `matched_screenshots=${summary.matchedScreenshots || 0}`,
+          `missing_in_baseline=${summary.missingInBaseline || 0}`,
+          `missing_in_current=${summary.missingInCurrent || 0}`,
+          `errors_count=${Array.isArray(summary.errors) ? summary.errors.length : 0}`
+        ].join('\n') + '\n';
+
+        await fs.appendFile(process.env.GITHUB_OUTPUT, outputs);
+        EOF