{"_id":"@alwaysonlabs/cypress-test-intelligence","_rev":"2-95baa1ed7cb5176b1b573102b571677a","name":"@alwaysonlabs/cypress-test-intelligence","dist-tags":{"latest":"1.0.1"},"versions":{"1.0.0":{"name":"@alwaysonlabs/cypress-test-intelligence","version":"1.0.0","keywords":["cypress","testing","cypress test","report","html","insights","test-explorer","tags","cypress/grep","metrics"],"author":{"name":"John Ringler"},"license":"MIT","_id":"@alwaysonlabs/cypress-test-intelligence@1.0.0","maintainers":[{"name":"alwaysonlabs","email":"johnringler@icloud.com"}],"homepage":"https://github.com/alwaysonlabs/cypress-test-intelligence#readme","bugs":{"url":"https://github.com/alwaysonlabs/cypress-test-intelligence/issues"},"bin":{"cypress-test-intelligence":"bin/cypress-test-intelligence.js"},"dist":{"shasum":"f3bfe25a8c70b29fe557bd065cf55c9c6d71d59e","tarball":"https://registry.npmjs.org/@alwaysonlabs/cypress-test-intelligence/-/cypress-test-intelligence-1.0.0.tgz","fileCount":14,"integrity":"sha512-CNf4ss7iaaSzemHtvi1wk/5ORqTerEnrbyt3x1MbVlSKrduAwvwTpwYwUgsQ1cEdCxV/qBdDjFwoRfuE7lQIJw==","signatures":[{"sig":"MEUCIQCNBYgStasSE1FQ6AJktK+eoURfd//ac+jjBSjjku1LXwIgMwIkZuguLoTlFSVk5M/g5U8OAi+mfXBa69hgIy57TLE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1560945},"main":"index.js","engines":{"node":">=14.0.0"},"gitHead":"bb62d42603669515a96c3fd6b699532d88e4aa79","scripts":{"demo":"node bin/cypress-test-intelligence.js --path ./cypress/e2e --open","start":"node bin/cypress-test-intelligence.js"},"_npmUser":{"name":"alwaysonlabs","email":"johnringler@icloud.com"},"repository":{"url":"git+https://github.com/alwaysonlabs/cypress-test-intelligence.git","type":"git"},"_npmVersion":"11.6.2","description":"Scan Cypress test files and generate insightful HTML reports with tag analysis, duplicate detection, and a full test explorer UI.","directories":{},"_nodeVersion":"24.12.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/cypress-test-intelligence_1.0.0_1776463878178_0.31370055784648954","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@alwaysonlabs/cypress-test-intelligence","version":"1.0.1","description":"Scan Cypress test files and generate insightful HTML reports with tag analysis, duplicate detection, and a full test explorer UI.","author":{"name":"John Ringler"},"main":"index.js","bin":{"cypress-test-intelligence":"bin/cypress-test-intelligence.js"},"scripts":{"start":"node bin/cypress-test-intelligence.js","demo":"node bin/cypress-test-intelligence.js --path ./cypress/e2e --open"},"keywords":["cypress","testing","cypress test","report","html","insights","test-explorer","tags","cypress/grep","metrics"],"license":"MIT","engines":{"node":">=14.0.0"},"repository":{"type":"git","url":"git+https://github.com/alwaysonlabs/cypress-test-intelligence.git"},"bugs":{"url":"https://github.com/alwaysonlabs/cypress-test-intelligence/issues"},"homepage":"https://github.com/alwaysonlabs/cypress-test-intelligence#readme","gitHead":"12635b3b798fccf0fec790d882935436625678ba","_id":"@alwaysonlabs/cypress-test-intelligence@1.0.1","_nodeVersion":"24.12.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-7ghfn5p3IN16n8WUalDRj8JLhTB7vsjXUASdxjVDFpnIV09bNhe4pfpW55RH8URx+mv7QG0iUDaXdqobHz/QJw==","shasum":"e31060d6a3b0fef376d59fcdd11fff59c88b6e62","tarball":"https://registry.npmjs.org/@alwaysonlabs/cypress-test-intelligence/-/cypress-test-intelligence-1.0.1.tgz","fileCount":15,"unpackedSize":7798169,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQClwfj2nR+HwIarTi6Dc0Q+XVbEsZu5xPVW30oWvq2WRAIgEuvMv4HkFSyk0uYRRDA4DWoHQVuWlFMsNjh1R9mOS0w="}]},"_npmUser":{"name":"alwaysonlabs","email":"johnringler@icloud.com"},"directories":{},"maintainers":[{"name":"alwaysonlabs","email":"johnringler@icloud.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/cypress-test-intelligence_1.0.1_1776466190624_0.7029869111156364"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-17T22:11:18.032Z","modified":"2026-04-17T22:49:51.086Z","1.0.0":"2026-04-17T22:11:18.425Z","1.0.1":"2026-04-17T22:49:50.998Z"},"bugs":{"url":"https://github.com/alwaysonlabs/cypress-test-intelligence/issues"},"author":{"name":"John Ringler"},"license":"MIT","homepage":"https://github.com/alwaysonlabs/cypress-test-intelligence#readme","keywords":["cypress","testing","cypress test","report","html","insights","test-explorer","tags","cypress/grep","metrics"],"repository":{"type":"git","url":"git+https://github.com/alwaysonlabs/cypress-test-intelligence.git"},"description":"Scan Cypress test files and generate insightful HTML reports with tag analysis, duplicate detection, and a full test explorer UI.","maintainers":[{"name":"alwaysonlabs","email":"johnringler@icloud.com"}],"readme":"# Cypress Test Intelligence\n\nStatic analysis reports for your Cypress test suite — no test run required.\n\nScan your test files and instantly generate a rich HTML report with a health score, tag analysis, duplicate detection, and a full interactive test explorer. Works on `.cy.js`, `.cy.ts`, `.spec.*`, and `.test.*` files.\n\n---\n\n## Preview\n\nSample report available [here](https://alwaysonlabs.github.io/cypress-test-intelligence/report.example.html).\n\n![Preview](assets/preview.gif)\n\n---\n\n## Features\n\n- **No test run needed** — parses source files directly\n- **Health score** — based on skipped and `.only` tests\n- **Tag analysis** — distribution charts for `@smoke`, `@regression`, etc.\n- **Issue detection** — flags empty suites and duplicate test/suite names\n- **Test Explorer** — search, filter by tag/folder/modifier, sort, expand/collapse\n- **Dark & light themes** — toggle in the report or set at generation time\n- **Fully self-contained** — a single portable HTML file, no external dependencies\n\n---\n\n## Installation\n\n### Global (run from any project)\n\n```bash\nnpm install -g @alwaysonlabs/cypress-test-intelligence\ncypress-test-intelligence --path cypress/e2e --open\n```\n\n### Local (per project)\n\n```bash\nnpm install --save-dev @alwaysonlabs/cypress-test-intelligence\nnpx cypress-test-intelligence --path cypress/e2e --open\n```\n\n---\n\n## Quick Start\n\nRun from the root of your project (where `cypress/` lives):\n\n```bash\nnpx cypress-test-intelligence\n```\n\nThis scans `./cypress/e2e`, writes `./cypress-test-intelligence.html`, and prints the output path. Open the file in any browser.\n\n---\n\n## CLI Options\n\n```bash\ncypress-test-intelligence [options]\ncypress-test-intelligence --config <file>\n```\n\n| Flag | Description | Default |\n| -- | -- | -- |\n| `--config <file>` | Load options from a JSON config file (CLI flags override) | — |\n| `--path <path>` | Path to Cypress test files | `cypress/e2e` |\n| `--exclude <folders>` | Comma-separated folder names to exclude | — |\n| `-o, --output <path>` | Output HTML file path | `./cypress-test-intelligence.html` |\n| `-t, --title <text>` | Report page title | `Cypress Test Intelligence` |\n| `--overview-text <text>` | Custom description in the Test Overview section | built-in sentence |\n| `--logo <path\\|url>` | Custom logo — local file path or URL | layers icon |\n| `--theme dark\\|light` | Color theme | `dark` |\n| `--sort alpha\\|tests\\|size` | Initial sort order in Test Explorer | `alpha` |\n| `--open` | Open the report in a browser after generation | `false` |\n| `--no-support-button` | Hide the \"Buy me a coffee\" button | shown |\n| `--no-environment` | Hide the Environment section | shown |\n| `--no-tags` | Hide all tag-related UI (see below) | shown |\n| `-h, --help` | Show help | — |\n\n### `--no-tags` in detail\n\nWhen tags are not used in a project, pass `--no-tags` to produce a cleaner report. This removes:\n\n- The entire **Tag Analysis** section\n- The **Tags** filter dropdown in Test Explorer\n- The **Untagged** filter tab in Test Explorer\n\n### `--logo`\n\nAccepts a local file path (PNG, JPG, SVG, GIF, WebP) or any URL. Local files are embedded as base64 so the report stays self-contained.\n\n```bash\n# Local file\ncypress-test-intelligence --logo ./assets/my-logo.png\n\n# URL\ncypress-test-intelligence --logo https://example.com/logo.svg\n```\n\n---\n\n## Config File\n\nFor repeatable or CI runs, store your options in a JSON config file and point to it with `--config`. Any CLI flag you pass alongside `--config` will override the corresponding value in the file.\n\n```bash\nnpx cypress-test-intelligence --config report-options.json\nnpx cypress-test-intelligence --config report-options.json --open   # override: open after generation\n```\n\n### Config file format\n\n```json\n{\n  \"path\": \"cypress/e2e\",\n  \"exclude\": \"cypress/examples,cypress/fixtures\",\n  \"output\": \"./reports/test-report.html\",\n  \"title\": \"My App — Test Report\",\n  \"overviewText\": \"Automated test coverage for the billing and auth flows.\",\n  \"logo\": \"./assets/logo.png\",\n  \"theme\": \"dark\",\n  \"sort\": \"alpha\",\n  \"open\": false,\n  \"showSupportButton\": true,\n  \"showEnvironment\": true,\n  \"showTags\": true\n}\n```\n\nAll keys are optional and fall back to the same defaults as the CLI.\n\n---\n\n## Examples\n\n```bash\n# Basic run, open in browser\nnpx cypress-test-intelligence --open\n\n# Different test folder, light theme\nnpx cypress-test-intelligence --path src/tests --theme light --open\n\n# Custom output path and title\nnpx cypress-test-intelligence -o reports/nightly.html -t \"Nightly Suite\"\n\n# Exclude folders\nnpx cypress-test-intelligence --exclude \"cypress/examples,cypress/fixtures\"\n\n# Project with no tags — clean report without tag UI\nnpx cypress-test-intelligence --no-tags\n\n# Minimal report for CI (no support button, no environment footer)\nnpx cypress-test-intelligence --no-support-button --no-environment -o reports/ci.html\n\n# Using a config file\nnpx cypress-test-intelligence --config report-options.json --open\n```\n\n---\n\n## npm Script Integration\n\nAdd a script to `package.json` so anyone on the team can generate the report with a single command:\n\n```json\n{\n  \"scripts\": {\n    \"test:report\": \"cypress-test-intelligence --config report-options.json --open\"\n  }\n}\n```\n\nThen run:\n\n```bash\nnpm run test:report\n```\n\n---\n\n## Report Sections\n\n| Section | Description |\n| -- | -- |\n| **Test Overview** | File, suite, and test counts; health score donut; skipped/only breakdown |\n| **Tag Analysis** | Per-tag suite and test counts; multi-select filter with distribution charts |\n| **Issues** | Empty suites, duplicate suite names, duplicate test names |\n| **Test Explorer** | Full interactive list with search, folder/tag/modifier filters, sort, expand/collapse |\n| **Environment** | Test path, Node.js version, platform, tool version, generation timestamp |\n\n---\n\n## Requirements\n\n- Node.js 14 or later\n- Cypress test files (`.cy.js`, `.cy.ts`, `.spec.js`, `.spec.ts`, `.test.js`, `.test.ts`)\n\n---\n\n## License\n\nMIT — [AlwaysOnLabs](https://github.com/alwaysonlabs)\n","readmeFilename":"README.md"}