👷 ci: add PR quality gates, commit message enforcement, and QA ICU fix

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,66 @@
+## Summary
+
+<!-- What does this PR do and why? Keep it brief. -->
+
+## Type
+
+<!-- Check one. -->
+
+- [ ] `feat` — new user-facing feature
+- [ ] `fix` — bug fix
+- [ ] `refactor` — restructure without behavior change
+- [ ] `chore` — build, deps, config, docs
+- [ ] `perf` — performance improvement
+- [ ] `test` — test coverage
+
+## Changes
+
+<!-- Key changes — what was modified and how.
+     One line per file or logical group. -->
+
+| File | Change |
+|------|--------|
+|      |        |
+
+## Migration Notes
+
+<!-- Fill this section only when database migrations are involved.
+     Delete this section entirely if no migrations are needed.
+
+     All migrations MUST be placed in the migrations/ directory following
+     the naming convention: YYYYMMDDHHMMSS_description.php
+     extending AbstractMatecatMigration. -->
+
+- [ ] Migration file added in `migrations/` directory
+- [ ] Backward-compatible with current production schema
+- [ ] NOT backward-compatible — breaking changes documented in Notes section
+- [ ] Tested on a fresh database and on an existing one
+
+## Testing
+
+<!-- How did you verify this works? Check all that apply. -->
+
+- [ ] `vendor/bin/phpunit --exclude-group=ExternalServices --no-coverage` passes
+- [ ] `./vendor/bin/phpstan` passes (0 errors, with baseline)
+- [ ] Manual testing performed (describe below)
+- [ ] New tests added for changed behavior
+- [ ] Regression tests added for bug fixes
+
+<!-- Paste relevant test output or describe manual testing steps. -->
+
+## AI Disclosure
+
+<!-- If AI tools were used to write or review code in this PR, disclose it.
+     AI-assisted code is welcome, but you must understand everything you ship.
+     Unreviewed AI output will not be merged. -->
+
+- [ ] No AI tools were used in this PR
+- [ ] AI tools were used — details below
+
+<!-- If AI was used, just name the agent/tool.
+     Example: "Claude Code (claude-opus-4-6)" -->
+
+## Notes
+
+<!-- Anything reviewers should know — breaking changes, follow-up work,
+     deployment steps, or open questions. Leave blank if none. -->

.github/scripts/commit-message-check.js

@@ -0,0 +1,160 @@
+'use strict';
+
+// ── Canonical emoji ↔ type map (from conventional-commit.prompt.md) ──
+
+const EMOJI_TYPE_MAP = {
+    '\u{1F3D7}\uFE0F': 'build',    // 🏗️
+    '\u{1F527}':       'chore',    // 🔧
+    '\u{1F477}':       'ci',       // 👷
+    '\u{1F4DD}':       'docs',     // 📝
+    '\u2728':          'feat',     // ✨
+    '\u{1F41B}':       'fix',      // 🐛
+    '\u26A1\uFE0F':    'perf',     // ⚡️
+    '\u267B\uFE0F':    'refactor', // ♻️
+    '\u23EA\uFE0F':    'revert',   // ⏪️
+    '\u{1F484}':       'style',    // 💄
+    '\u2705':          'test',     // ✅
+    '\u{1F310}':       'i18n',     // 🌐
+};
+
+const TYPE_EMOJI_MAP = Object.fromEntries(
+    Object.entries(EMOJI_TYPE_MAP).map(([emoji, type]) => [type, emoji]),
+);
+
+const VALID_TYPES = Object.values(EMOJI_TYPE_MAP);
+
+const MAX_SUBJECT_LENGTH = 100;
+
+// ── Helpers ──────────────────────────────────────────────────────────
+
+/**
+ * Strip Unicode variation selector 16 (U+FE0F) for comparison.
+ * Some editors/terminals include it, others don't.
+ */
+function stripVS16(str) {
+    return str.replace(/\uFE0F/g, '');
+}
+
+/**
+ * Find the conventional type for a given emoji.
+ * Matches with or without the trailing VS16 character.
+ */
+function findTypeForEmoji(emoji) {
+    const normalized = stripVS16(emoji);
+    for (const [key, type] of Object.entries(EMOJI_TYPE_MAP)) {
+        if (stripVS16(key) === normalized) {
+            return type;
+        }
+    }
+    return null;
+}
+
+function isAutoGenerated(subject) {
+    return /^Merge /.test(subject);
+}
+
+function isGitHubWebEdit(subject) {
+    return /^(Update|Create|Delete|Rename) .+/.test(subject);
+}
+
+// ── Core validation ──────────────────────────────────────────────────
+
+function validateCommitMessage(message, {requireEmoji = true} = {}) {
+    const errors = [];
+
+    if (!message || typeof message !== 'string') {
+        return {valid: false, errors: ['Empty or invalid commit message'], skipped: false};
+    }
+
+    const subject = message.split('\n')[0].trim();
+
+    if (!subject) {
+        return {valid: false, errors: ['Empty subject line'], skipped: false};
+    }
+
+    if (isAutoGenerated(subject)) {
+        return {valid: true, errors: [], skipped: true};
+    }
+
+    if (!requireEmoji && isGitHubWebEdit(subject)) {
+        return {valid: true, errors: [], skipped: true};
+    }
+
+    if (subject.length > MAX_SUBJECT_LENGTH) {
+        errors.push(
+            `Subject exceeds ${MAX_SUBJECT_LENGTH} characters (${subject.length})`,
+        );
+    }
+
+    const firstSpace = subject.indexOf(' ');
+    if (firstSpace === -1) {
+        errors.push(
+            requireEmoji
+                ? 'Subject must start with an emoji followed by a space'
+                : 'Subject must contain a space',
+        );
+        return {valid: false, errors, skipped: false};
+    }
+
+    const firstToken = subject.slice(0, firstSpace);
+    const rest = subject.slice(firstSpace + 1);
+
+    const emojiType = findTypeForEmoji(firstToken);
+    const hasEmoji = emojiType !== null;
+
+    if (requireEmoji && !hasEmoji) {
+        const validList = Object.entries(EMOJI_TYPE_MAP)
+            .map(([e, t]) => `${e} ${t}`)
+            .join(', ');
+        errors.push(`Unknown emoji "${firstToken}". Valid: ${validList}`);
+    }
+
+    const textToParse = hasEmoji ? rest : subject;
+    const formatMatch = textToParse.match(/^(\w+)(?:\(([^)]+)\))?(!)?: (.+)$/);
+    if (!formatMatch) {
+        errors.push(
+            hasEmoji
+                ? 'Format after emoji must be: <type>[(<scope>)][!]: <description>'
+                : 'Format must be: <type>[(<scope>)][!]: <description>',
+        );
+        return {valid: false, errors, skipped: false};
+    }
+
+    const [, type, , , description] = formatMatch;
+
+    if (!VALID_TYPES.includes(type)) {
+        errors.push(
+            `Invalid type "${type}". Valid: ${VALID_TYPES.join(', ')}`,
+        );
+    }
+
+    if (hasEmoji && emojiType && VALID_TYPES.includes(type) && emojiType !== type) {
+        const correctEmoji = TYPE_EMOJI_MAP[type] || '?';
+        errors.push(
+            `Emoji ${firstToken} is for "${emojiType}", not "${type}". ` +
+            `Use ${correctEmoji} for "${type}"`,
+        );
+    }
+
+    if (description && /^[A-Z]/.test(description)) {
+        errors.push('Description must start with a lowercase letter');
+    }
+
+    if (description && description.endsWith('.')) {
+        errors.push('Description must not end with a period');
+    }
+
+    return {valid: errors.length === 0, errors, skipped: false};
+}
+
+module.exports = {
+    EMOJI_TYPE_MAP,
+    TYPE_EMOJI_MAP,
+    VALID_TYPES,
+    MAX_SUBJECT_LENGTH,
+    validateCommitMessage,
+    findTypeForEmoji,
+    isAutoGenerated,
+    isGitHubWebEdit,
+    stripVS16,
+};