{"id":26378,"library":"semantic-release-commits-lint","title":"semantic-release-commits-lint","description":"semantic-release plugin that analyzes commit messages using commitlint. Works with semantic-release >=20 and commitlint configurations. Provides analyzeCommits step. Version 1.1.0 adds support for commitlintFile and commitlintConfig options. Requires Node >=18 and peer dependencies jest, semantic-release, and xo. Alternative to built-in commit message analysis with custom commitlint rules.","status":"active","version":"1.1.0","language":"javascript","source_language":"en","source_url":"https://github.com/BondarenkoAlex/semantic-release-commits-lint","tags":["javascript","changelog","commitlint","commits","lint","conventional-changelog","conventional-commits","publish","release"],"install":[{"cmd":"npm install semantic-release-commits-lint","lang":"bash","label":"npm"},{"cmd":"yarn add semantic-release-commits-lint","lang":"bash","label":"yarn"},{"cmd":"pnpm add semantic-release-commits-lint","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"peer dependency required by plugin","package":"jest","optional":false},{"reason":"peer dependency, plugin requires semantic-release >=20","package":"semantic-release","optional":false},{"reason":"peer dependency required by plugin","package":"xo","optional":false}],"imports":[{"note":"Used as a semantic-release plugin in .releaserc or release.config.js, not imported directly in code.","wrong":"require('semantic-release-commits-lint')","symbol":"default","correct":"plugins: ['semantic-release-commits-lint']"},{"note":"analyzeCommits is not a public export; it is registered automatically when using the plugin string.","wrong":"import { analyzeCommits } from 'semantic-release-commits-lint'","symbol":"analyzeCommits","correct":"// Not exported; plugin provides step internally"},{"note":"commitlintConfig allows inline config, avoid mixing both options.","wrong":"[\"semantic-release-commits-lint\", { commitlintConfig: { extends: [] } }]","symbol":"options","correct":"[\"semantic-release-commits-lint\", { commitlintFile: \".commitlintrc.json\" }]"}],"quickstart":{"code":"// .releaserc\n{\n  \"plugins\": [\n    \"semantic-release-commits-lint\"\n  ]\n}","lang":"javascript","description":"Example of configuring the plugin in semantic-release without additional options."},"warnings":[{"fix":"Ensure commitlint config file exists or pass commitlintConfig option.","message":"Plugin requires commitlint configuration to be present; otherwise, it may silently pass.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Check xo repository for alternative or compatibility.","message":"Deprecated: peer dependency xo may not be maintained.","severity":"deprecated","affected_versions":">=1.0.0"},{"fix":"Upgrade Node to v18 or later.","message":"Plugin only supports Node >=18. Older Node versions cause runtime errors.","severity":"breaking","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run npm install semantic-release-commits-lint --save-dev","cause":"Plugin not installed or not in node_modules.","error":"Error: Cannot find module 'semantic-release-commits-lint'"},{"fix":"Use string in plugins array, not imported symbol.","cause":"Using import or require incorrectly.","error":"TypeError: Cannot read properties of undefined (reading 'analyzeCommits')"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}