mova-run-gates-wrapper
Runs npm validate/test/smoke gates and emits a JSON gate report with log paths.
When & Why to Use This Skill
The MOVA: run gates skill is a specialized automation tool designed to streamline the software quality assurance process. It executes a sequence of critical npm-based validation gates—including validation, unit testing, and smoke tests—and consolidates the results into a structured JSON report. By automating the collection of log paths and execution statuses, it ensures that developers and DevOps teams have a reliable, deterministic 'pass sweep' before code is merged or promoted to production.
Use Cases
- Pre-merge Validation: Automatically run a full suite of npm validation and unit tests to ensure code quality and prevent regressions before merging pull requests.
- Deployment Readiness: Execute smoke tests (smoke:wf_cycle) to verify system stability and core functionality before handing off builds to Operations or SRE teams.
- Automated Evidence Collection: Generate structured JSON reports and log artifacts for audit trails, providing clear, timestamped evidence of successful test execution.
- CI/CD Pipeline Integration: Act as a standardized wrapper for local or remote environments to ensure consistent execution of quality gates across different development stages.
- Failure Analysis: Utilize the centralized log paths and status reports to quickly identify and fix specific gate failures before re-running the full validation sweep.
| name | "MOVA: run gates (wrapper)" |
|---|---|
| description | "Runs npm validate/test/smoke gates and emits a JSON gate report with log paths." |
| - kind | json |
| schema | "artifacts/run_gates/<timestamp>/run_gates_report.json" |
| deterministic | true |
Command
node .codex/skills/mova_run_gates/scripts/run.mjs
Notes
- Wrapper runs
npm run validate,npm test, andnpm run smoke:wf_cycle, storing logs underartifacts/run_gates/<timestamp>/. - The JSON report contains status/duration/log path per gate and is also saved next to the logs for evidence uploads.
- If a step fails the remaining gates are marked
skipped; fix the failure before relaunching for a clean PASS sweep.