@diplodoc/lint 1.9.1 → 1.10.0

package/.husky/commit-msg

@@ -0,0 +1,49 @@
+COMMIT_MSG_FILE="$1"
+COMMIT_MSG=$(cat "$COMMIT_MSG_FILE")
+
+# Check if commit message contains Cyrillic characters
+# All commit messages must be in English per .agents/style-and-testing.md
+if echo "$COMMIT_MSG" | grep -q '[А-Яа-яЁё]'; then
+    echo "❌ Error: Commit message contains Cyrillic characters."
+    echo ""
+    echo "All commit messages must be in English per .agents/style-and-testing.md"
+    echo "Please rewrite your commit message in English."
+    echo ""
+    echo "Current commit message:"
+    echo "$COMMIT_MSG"
+    exit 1
+fi
+
+# Extract the first line (subject) of commit message
+SUBJECT=$(echo "$COMMIT_MSG" | head -n1)
+
+# Allow fixup! and squash! prefixes (for git commit --fixup and --squash)
+if echo "$SUBJECT" | grep -qE '^(fixup!|squash!)'; then
+    exit 0
+fi
+
+# Check Conventional Commits format: <type>(<scope>): <subject>
+# Types: feat, fix, perf, refactor, docs, chore, revert
+# Scope is optional
+if ! echo "$SUBJECT" | grep -qE '^(feat|fix|perf|refactor|docs|chore|revert)(\([^)]+\))?: .+'; then
+    echo "❌ Error: Commit message does not follow Conventional Commits format."
+    echo ""
+    echo "Expected format: <type>(<scope>): <subject>"
+    echo ""
+    echo "Types: feat, fix, perf, refactor, docs, chore, revert"
+    echo "Scope is optional"
+    echo ""
+    echo "Examples:"
+    echo "  feat(cli): add new command"
+    echo "  fix(transform): handle edge case"
+    echo "  docs(readme): update installation"
+    echo ""
+    echo "For fixing previous commits, use:"
+    echo "  fixup! <original commit message>"
+    echo ""
+    echo "Current commit message:"
+    echo "$SUBJECT"
+    exit 1
+fi
+
+exit 0

package/.lintstagedrc.js

@@ -8,16 +8,14 @@ const {readFileSync} = require('node:fs');
 const {join} = require('node:path');
 
 // Check if this is the @diplodoc/lint package itself
-function isLintPackage() {
+const isLintPkg = (() => {
     try {
-        const packageJson = JSON.parse(readFileSync(join(process.cwd(), 'package.json'), 'utf8'));
-        return packageJson.name === '@diplodoc/lint';
+        const pkg = JSON.parse(readFileSync(join(process.cwd(), 'package.json'), 'utf8'));
+        return pkg.name === '@diplodoc/lint';
     } catch {
         return false;
     }
-}
-
-const isLintPkg = isLintPackage();
+})();
 
 module.exports = {
     // Exclude config files from linting (they use CommonJS)
@@ -33,15 +31,17 @@ module.exports = {
         const filtered = filenames.filter(
             (f) =>
                 !configFiles.some((config) => f.includes(config)) &&
-                // For @diplodoc/lint package itself: exclude bin/ (internal scripts)
-                !(isLintPkg && f.includes('bin/')),
+                // For @diplodoc/lint package itself: exclude bin/ and scripts/ (in .eslintignore)
+                !(isLintPkg && (f.includes('bin/') || f.includes('scripts/'))),
         );
         if (filtered.length === 0) {
             return [];
         }
         return [
             ...filtered.map((f) => `prettier --write ${f}`),
-            ...filtered.map((f) => `eslint --max-warnings=0 --fix ${f}`),
+            ...filtered.map(
+                (f) => `env ESLINT_USE_FLAT_CONFIG=false npx eslint --max-warnings=0 --fix ${f}`,
+            ),
         ];
     },
     // Handle .lintstagedrc.js separately (only prettier, no eslint)

package/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "1.9.1"
+  ".": "1.10.0"
 }

package/AGENTS.md

@@ -42,6 +42,7 @@ This file contains instructions for AI agents working with the `@diplodoc/lint`
   - `.stylelintrc.js` — Stylelint configuration template
   - `.lintstagedrc.js` — lint-staged configuration template
   - `.husky/pre-commit` — Husky pre-commit hook template
+  - `.husky/commit-msg` — Husky commit-msg hook template (validates commit messages are in English)
 - `scripts/` — helper scripts for package.json and .ignore file modification
   - `modify-package.js` — adds lint scripts to package.json
   - `modify-ignore.js` — updates .ignore files with standard patterns
@@ -413,6 +414,13 @@ Files in `scaffolding/` are copied to packages during `init`/`update`:
 
 - Runs `npm run pre-commit` before each commit
 - Pre-commit script runs `lint update && lint-staged`
+
+**`.husky/commit-msg`**:
+
+- Validates that commit messages follow Conventional Commits format (per `.agents/style-and-testing.md`)
+- Validates that commit messages are in English (rejects Cyrillic characters)
+- Allows `fixup!` and `squash!` prefixes for git commit --fixup/--squash
+- Provides helpful error messages with examples and reference to style guide
 - lint-staged automatically runs unit tests when relevant files are changed
 
 **Ignore Files** (updated via `modify-ignore.js`):
@@ -487,13 +495,11 @@ npm run test:old
 ## Code Conventions
 
 1. **File naming**:
-
    - Config files: `*-config.js` (e.g., `eslint-common-config.js`)
    - Scripts: `modify-*.js` in `scripts/` directory
    - Binaries: executable scripts in `bin/` directory
 
 2. **Comments and documentation**:
-
    - **All code comments must be in English**
    - **All documentation files (ADR, AGENTS.md, README, etc.) must be in English**
 

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [1.10.0](https://github.com/diplodoc-platform/lint/compare/v1.9.2...v1.10.0) (2026-01-15)
+
+
+### Features
+
+* **lint:** add commit-msg hook for validation ([06aa520](https://github.com/diplodoc-platform/lint/commit/06aa520e80c189116d891d7dc3b48535cf479d3d))
+
+
+### Bug Fixes
+
+* **lint:** remove deprecated husky lines from commit-msg hook ([6aca178](https://github.com/diplodoc-platform/lint/commit/6aca178046d0d55eceee0f3341c6b46eb1c570e4))
+
+## [1.9.2](https://github.com/diplodoc-platform/lint/compare/v1.9.1...v1.9.2) (2025-12-29)
+
+
+### Bug Fixes
+
+* use ESLINT_USE_FLAT_CONFIG=false in lint-staged ([88a17b6](https://github.com/diplodoc-platform/lint/commit/88a17b62a791cc491f195ed66b69f63964f89f9b))
+
 ## [1.9.1](https://github.com/diplodoc-platform/lint/compare/v1.9.0...v1.9.1) (2025-12-29)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diplodoc/lint",
-  "version": "1.9.1",
+  "version": "1.10.0",
   "description": "Diplodoc platform internal utility set for linting",
   "bin": {
     "lint": "./bin/lint.js",

package/scaffolding/.husky/commit-msg

@@ -0,0 +1,49 @@
+COMMIT_MSG_FILE="$1"
+COMMIT_MSG=$(cat "$COMMIT_MSG_FILE")
+
+# Check if commit message contains Cyrillic characters
+# All commit messages must be in English per .agents/style-and-testing.md
+if echo "$COMMIT_MSG" | grep -q '[А-Яа-яЁё]'; then
+    echo "❌ Error: Commit message contains Cyrillic characters."
+    echo ""
+    echo "All commit messages must be in English per .agents/style-and-testing.md"
+    echo "Please rewrite your commit message in English."
+    echo ""
+    echo "Current commit message:"
+    echo "$COMMIT_MSG"
+    exit 1
+fi
+
+# Extract the first line (subject) of commit message
+SUBJECT=$(echo "$COMMIT_MSG" | head -n1)
+
+# Allow fixup! and squash! prefixes (for git commit --fixup and --squash)
+if echo "$SUBJECT" | grep -qE '^(fixup!|squash!)'; then
+    exit 0
+fi
+
+# Check Conventional Commits format: <type>(<scope>): <subject>
+# Types: feat, fix, perf, refactor, docs, chore, revert
+# Scope is optional
+if ! echo "$SUBJECT" | grep -qE '^(feat|fix|perf|refactor|docs|chore|revert)(\([^)]+\))?: .+'; then
+    echo "❌ Error: Commit message does not follow Conventional Commits format."
+    echo ""
+    echo "Expected format: <type>(<scope>): <subject>"
+    echo ""
+    echo "Types: feat, fix, perf, refactor, docs, chore, revert"
+    echo "Scope is optional"
+    echo ""
+    echo "Examples:"
+    echo "  feat(cli): add new command"
+    echo "  fix(transform): handle edge case"
+    echo "  docs(readme): update installation"
+    echo ""
+    echo "For fixing previous commits, use:"
+    echo "  fixup! <original commit message>"
+    echo ""
+    echo "Current commit message:"
+    echo "$SUBJECT"
+    exit 1
+fi
+
+exit 0

package/scaffolding/.lintstagedrc.js

@@ -8,16 +8,14 @@ const {readFileSync} = require('node:fs');
 const {join} = require('node:path');
 
 // Check if this is the @diplodoc/lint package itself
-function isLintPackage() {
+const isLintPkg = (() => {
     try {
-        const packageJson = JSON.parse(readFileSync(join(process.cwd(), 'package.json'), 'utf8'));
-        return packageJson.name === '@diplodoc/lint';
+        const pkg = JSON.parse(readFileSync(join(process.cwd(), 'package.json'), 'utf8'));
+        return pkg.name === '@diplodoc/lint';
     } catch {
         return false;
     }
-}
-
-const isLintPkg = isLintPackage();
+})();
 
 module.exports = {
     // Exclude config files from linting (they use CommonJS)
@@ -33,15 +31,17 @@ module.exports = {
         const filtered = filenames.filter(
             (f) =>
                 !configFiles.some((config) => f.includes(config)) &&
-                // For @diplodoc/lint package itself: exclude bin/ (internal scripts)
-                !(isLintPkg && f.includes('bin/')),
+                // For @diplodoc/lint package itself: exclude bin/ and scripts/ (in .eslintignore)
+                !(isLintPkg && (f.includes('bin/') || f.includes('scripts/'))),
         );
         if (filtered.length === 0) {
             return [];
         }
         return [
             ...filtered.map((f) => `prettier --write ${f}`),
-            ...filtered.map((f) => `eslint --max-warnings=0 --fix ${f}`),
+            ...filtered.map(
+                (f) => `env ESLINT_USE_FLAT_CONFIG=false npx eslint --max-warnings=0 --fix ${f}`,
+            ),
         ];
     },
     // Handle .lintstagedrc.js separately (only prettier, no eslint)

package/scripts/modify-ignore.js

@@ -20,22 +20,6 @@ const INSTALL = [
     'node_modules',
 ];
 
-// Check if this is the @diplodoc/lint package itself
-function isLintPackage() {
-    try {
-        const packageJsonPath = join(process.cwd(), 'package.json');
-        if (!existsSync(packageJsonPath)) {
-            return false;
-        }
-        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
-        return packageJson.name === '@diplodoc/lint';
-    } catch {
-        return false;
-    }
-}
-
-const isLintPkg = isLintPackage();
-
 const ignores = {
     '.gitignore': [
         ...SYSTEM,
@@ -53,8 +37,6 @@ const ignores = {
         '.stylelintrc.js',
         // Build scripts that use newer syntax not yet supported by ESLint parser
         'esbuild/**/*.mjs',
-        // For @diplodoc/lint package itself: bin/ contains internal scripts
-        ...(isLintPkg ? ['bin/'] : []),
     ],
     '.prettierignore': [
         ...SYSTEM,

package/scripts/modify-release-please.js

@@ -32,27 +32,18 @@ const configContent = configTemplate
 
 const manifestContent = manifestTemplate
     .replace(/\{\{PACKAGE_VERSION\}\}/g, packageVersion)
-    .trimEnd(); // Remove trailing whitespace/newlines
+    .trimEnd() + '\n'; // Remove trailing whitespace/newlines
 
 // Write files
 const configOutputPath = join(process.cwd(), '.release-please-config.json');
 const manifestOutputPath = join(process.cwd(), '.release-please-manifest.json');
 
-// Only create if they don't exist (preserve existing configs)
 if (!existsSync(configOutputPath)) {
-    writeFileSync(configOutputPath, configContent, 'utf8');
     console.log('[@diplodoc/lint]', '=> Create .release-please-config.json');
-} else {
-    console.log('[@diplodoc/lint]', '=> .release-please-config.json already exists, skipping');
+    writeFileSync(configOutputPath, configContent, 'utf8');
 }
 
-if (!existsSync(manifestOutputPath)) {
-    writeFileSync(manifestOutputPath, manifestContent, 'utf8');
-    console.log('[@diplodoc/lint]', '=> Create .release-please-manifest.json');
-} else {
-    // Always update manifest with current version
-    writeFileSync(manifestOutputPath, manifestContent, 'utf8');
-    console.log('[@diplodoc/lint]', '=> Update .release-please-manifest.json');
-}
+console.log('[@diplodoc/lint]', '=> Update .release-please-manifest.json');
+writeFileSync(manifestOutputPath, manifestContent, 'utf8');