commitlint-plugin-tense

Commitlint Plugin Tense

A commitlint plugin that checks tense

Getting Started

npm install --save-dev commitlint-plugin-tense

And configure commitlint.config.js to use the tense plugin.

module.exports = {
  plugins: ['commitlint-plugin-tense'],
  rules: {
    'tense/subject-tense': [1, 'always']
  }
}

subject-tense

• condition: subject is verbalized in tense present in allowedTenses

'tense/subject-tense': [severity, when, options]

• severity: 0 disable, 1 warning, or 2 error
• when: always or never
• options

{
  // Array of tenses allowed
  allowedTenses: ['present-imperative'],
  // Check the first verb only or all verbs
  // Accuracy is low when checking all verbs, use with warning level only
  firstOnly: true,
  // A list of additional allowed words
  allowlist: [],
}

Tenses

[
  'past-participle', // done
  'past-tense', // did
  'present-imperative', // do
  'present-participle', // doing
  'present-third-person' // does
]

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/actuallydamo/commitlint-plugin-tense

Changelog

1.0.6 (2025-02-24)

Bug Fixes

• expand don't for lexer (2e01732)
• make the plugin case-insensitive (b88127c)