🔧 update: enhance commit message validation for breaking changes

Author: warengonzaga

.husky/validate-commit-msg.mjs

@@ -20,15 +20,30 @@ const firstLine = raw.replace(/\r/g, "").split("\n")[0].trim();
 if (/^Merge /.test(firstLine) || /^Revert /.test(firstLine)) process.exit(0);
 
 // Clean Commit convention pattern
-// Format: <emoji> <type>[(<scope>)]: <description>
+// Format: <emoji> <type>[!][(<scope>)]: <description>
 const pattern =
-  /^(📦|🔧|🗑\uFE0F?|🔒|⚙\uFE0F?|☕|🧪|📖|🚀) (new|update|remove|security|setup|chore|test|docs|release)( \([a-z0-9][a-z0-9-]*\))?: .{1,72}$/u;
+  /^(📦|🔧|🗑\uFE0F?|🔒|⚙\uFE0F?|☕|🧪|📖|🚀) (new|update|remove|security|setup|chore|test|docs|release)(!?)( \([a-z0-9][a-z0-9-]*\))?: .{1,72}$/u;
+
+// Only new, update, remove, security may use the breaking change marker
+const breakingMatch = firstLine.match(pattern);
+if (breakingMatch) {
+  const type = breakingMatch[2];
+  const bang = breakingMatch[3];
+  if (bang === '!' && !['new', 'update', 'remove', 'security'].includes(type)) {
+    console.error('');
+    console.error('✖ Breaking change marker (!) is only allowed for: new, update, remove, security');
+    console.error('');
+    process.exit(1);
+  }
+}
 
 if (!pattern.test(firstLine)) {
   console.error("");
   console.error("✖ Invalid commit message format.");
   console.error("");
-  console.error("  Expected: <emoji> <type>[(<scope>)]: <description>");
+  console.error("  Expected: <emoji> <type>[!][(<scope>)]: <description>");
+  console.error("");
+  console.error("  Use ! after type for breaking changes (new, update, remove, security only)");
   console.error("");
   console.error("  Types and emojis:");
   console.error("    📦 new      – new features, files, or capabilities");
@@ -45,6 +60,8 @@ if (!pattern.test(firstLine)) {
   console.error("    📦 new: user authentication system");
   console.error("    🔧 update (api): improve error handling");
   console.error("    ⚙️  setup (ci): configure github actions workflow");
+  console.error("    📦 new!: completely redesign authentication system");
+  console.error("    🔧 update! (api): change response format for all endpoints");
   console.error("");
   console.error("  Reference: https://github.com/wgtechlabs/clean-commit");
   console.error("");