chore: skip e2e tests for docs-only and ignorable-file PRs

[ashishjain0512]

Summary

Extends the e2e scope detection script (scripts/e2e-diagram-scope.mjs) to recognize ignorable files — files that can never affect rendered diagram output. When a PR touches only ignorable files (docs, changesets, AI config, etc.), the entire e2e job is now skipped instead of running the full 5-container Cypress suite.

This builds on the diagram-scoped e2e optimization from #7619.

Changes

scripts/e2e-diagram-scope.mjs

• Added IGNORABLE_PREFIXES list covering: docs source/generated, .changeset/, .claude/, assistant/, docs CI workflows, doc scripts
• Added IGNORABLE_SUFFIXES (.md files at repo root) with a guard to exclude .md files inside diagram source folders
• Added SKIP sentinel return value (exported) when all changed files are ignorable
• Ignorable files get continue (skipped) instead of break (triggering full suite)

.github/workflows/e2e.yml

• detect-scope step now handles the SKIP output value
• e2e job has an if: condition to skip entirely when SKIP is returned

scripts/run-e2e-scoped.ts

• Local runner handles SKIP with early exit and clear message

scripts/e2e-diagram-scope.spec.ts

• 9 new test cases covering: docs-only, root markdown, changesets, generated docs, AI config, docs CI workflows, mixed (docs + diagram), mixed (docs + shared code), non-docs CI

package.json

• Pinned @argos-ci/cypress to ^6.2.12 for ARGOS_SUBSET support (minimum version with this feature). Versions 6.3.x have a packaging bug where exports maps point to dist/task.js but the package ships dist/task.mjs instead, causing Cannot find module errors in CI.

.cspell/code-terms.txt

• Added CODEOWNERS to the spell-check dictionary

Detection behavior matrix

PR changes	Result	e2e behavior
Only docs/changesets/AI config	SKIP	Job skipped entirely
Diagram source + docs	Scoped pattern	Scoped run (diagram specs only)
Shared code + docs	""	Full suite
Only diagram source	Scoped pattern	Scoped run
Unknown/root files (package.json, CI)	""	Full suite (conservative)

Tests

All 25 tests pass (including 9 new ignorable-file tests).

[changeset-bot]

⚠️ No Changeset found

Latest commit: 0cb8cc8

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[netlify]

✅ Deploy Preview for mermaid-js ready!

Name	Link
🔨 Latest commit	0cb8cc8
🔍 Latest deploy log	https://app.netlify.com/projects/mermaid-js/deploys/69f877eaf64e650008d574a6
😎 Deploy Preview	https://deploy-preview-7704--mermaid-js.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.
🤖 Make changes	Run an agent on this branch

---

To edit notification comments on pull requests, go to your Netlify project configuration.

[pkg-pr-new]

Open in StackBlitz

@mermaid-js/examples

npm i https://pkg.pr.new/@mermaid-js/examples@7704

mermaid

npm i https://pkg.pr.new/mermaid@7704

@mermaid-js/layout-elk

npm i https://pkg.pr.new/@mermaid-js/layout-elk@7704

@mermaid-js/layout-tidy-tree

npm i https://pkg.pr.new/@mermaid-js/layout-tidy-tree@7704

@mermaid-js/mermaid-zenuml

npm i https://pkg.pr.new/@mermaid-js/mermaid-zenuml@7704

@mermaid-js/parser

npm i https://pkg.pr.new/@mermaid-js/parser@7704

@mermaid-js/tiny

npm i https://pkg.pr.new/@mermaid-js/tiny@7704

commit: 0cb8cc8

[codecov]

Codecov Report

❌ Patch coverage is 0% with 50 lines in your changes missing coverage. Please review.
✅ Project coverage is 3.33%. Comparing base (84abc58) to head (0cb8cc8).
⚠️ Report is 24 commits behind head on develop.

Files with missing lines	Patch %	Lines
scripts/e2e-diagram-scope.mjs	0.00%	45 Missing ⚠️
scripts/run-e2e-scoped.ts	0.00%	5 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##           develop   #7704      +/-   ##
==========================================
- Coverage     3.33%   3.33%   -0.01%     
==========================================
  Files          542     542              
  Lines        56881   56928      +47     
  Branches       839     839              
==========================================
  Hits          1899    1899              
- Misses       54982   55029      +47     

Flag	Coverage Δ
unit	3.33% <0.00%> (-0.01%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
scripts/run-e2e-scoped.ts	4.00% <0.00%> (-0.77%)	⬇️
scripts/e2e-diagram-scope.mjs	0.00% <0.00%> (ø)

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[knsv]

👍

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
default (Inspect)	👍 Changes approved	3 changed	May 4, 2026, 10:55 AM