Fix test import style and document hooks in CLAUDE.md

- Replace mixed ESM/CJS import syntax in test file with consistent ESM imports throughout (both vitest and normalizer use import) - Add Git Hooks section to CLAUDE.md documenting install-hooks.sh and the commit-msg normalizer for new contributors Nightshift-Task: commit-normalize Nightshift-Ref: https://github.com/marcus/nightshift
Add commit message normalizer hook and install script
2026-03-20 02:07:30 -04:00 · 2026-03-20 02:04:04 -04:00
10 changed files with 325 additions and 424 deletions
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -29,6 +29,19 @@ td session --new         # force a new session in the same terminal context

 Task state is stored in `.todos/issues.db` (SQLite).

+## Git Hooks
+
+A commit-msg hook normalizes commit messages on every commit (capitalizes subject, strips trailing period, trims whitespace, warns when subject exceeds 72 characters). The hook never blocks a commit.
+
+**Wire hooks after cloning:**
+```bash
+sh scripts/install-hooks.sh
+# or via npm script:
+cd scripts && npm run hooks:install
+```
+
+The hook script lives at `scripts/commit-msg` and is invoked by `.git/hooks/commit-msg`. The normalizer logic is in `scripts/normalize-commit-msg.js` with unit tests in `scripts/__tests__/normalize-commit-msg.test.js` (run with `cd scripts && npm test`).
+
 ## Development

 **Run production stack (Docker):**
--- a/scripts/tests/normalize-commit-msg.test.js
+++ b/scripts/tests/normalize-commit-msg.test.js
@@ -0,0 +1,90 @@
+import { describe, it, expect } from 'vitest';
+import { normalizeSubject, normalizeMessage } from '../normalize-commit-msg.js';
+
+describe('normalizeSubject', () => {
+  it('passes an already-valid subject unchanged', () => {
+    const { subject, warned } = normalizeSubject('Add feature flag support');
+    expect(subject).toBe('Add feature flag support');
+    expect(warned).toBe(false);
+  });
+
+  it('capitalizes the first letter', () => {
+    const { subject } = normalizeSubject('add feature flag support');
+    expect(subject).toBe('Add feature flag support');
+  });
+
+  it('strips a trailing period', () => {
+    const { subject } = normalizeSubject('Add feature flag support.');
+    expect(subject).toBe('Add feature flag support');
+  });
+
+  it('trims leading whitespace', () => {
+    const { subject } = normalizeSubject('  Fix the bug');
+    expect(subject).toBe('Fix the bug');
+  });
+
+  it('trims trailing whitespace', () => {
+    const { subject } = normalizeSubject('Fix the bug   ');
+    expect(subject).toBe('Fix the bug');
+  });
+
+  it('capitalizes and strips period together', () => {
+    const { subject } = normalizeSubject('fix the bug.');
+    expect(subject).toBe('Fix the bug');
+  });
+
+  it('does not strip a period that is not trailing', () => {
+    const { subject } = normalizeSubject('Fix bug in v1.0 release');
+    expect(subject).toBe('Fix bug in v1.0 release');
+  });
+
+  it('warns when subject exceeds 72 characters', () => {
+    const long = 'A'.repeat(73);
+    const { warned } = normalizeSubject(long);
+    expect(warned).toBe(true);
+  });
+
+  it('does not warn when subject is exactly 72 characters', () => {
+    const exact = 'A'.repeat(72);
+    const { warned } = normalizeSubject(exact);
+    expect(warned).toBe(false);
+  });
+
+  it('does not warn when subject is under 72 characters', () => {
+    const { warned } = normalizeSubject('Short message');
+    expect(warned).toBe(false);
+  });
+
+  it('handles an empty subject gracefully', () => {
+    const { subject, warned } = normalizeSubject('');
+    expect(subject).toBe('');
+    expect(warned).toBe(false);
+  });
+});
+
+describe('normalizeMessage', () => {
+  it('normalizes only the subject line of a multi-line message', () => {
+    const input = 'fix the bug.\n\nThis is the body paragraph.';
+    const { message } = normalizeMessage(input);
+    expect(message).toBe('Fix the bug\n\nThis is the body paragraph.');
+  });
+
+  it('skips comment lines when finding the subject', () => {
+    const input = '# Comment\nfix the bug.';
+    const { message } = normalizeMessage(input);
+    expect(message).toBe('# Comment\nFix the bug');
+  });
+
+  it('returns warned true for long subject inside full message', () => {
+    const longSubject = 'x'.repeat(73);
+    const input = `${longSubject}\n\nBody.`;
+    const { warned } = normalizeMessage(input);
+    expect(warned).toBe(true);
+  });
+
+  it('preserves body lines exactly as-is', () => {
+    const input = 'Fix bug\n\n  - detail one\n  - detail two.';
+    const { message } = normalizeMessage(input);
+    expect(message).toBe('Fix bug\n\n  - detail one\n  - detail two.');
+  });
+});
--- a/scripts/bus-factor.mjs
+++ b/scripts/bus-factor.mjs
@@ -1,213 +0,0 @@
-#!/usr/bin/env node
-/**
- * Bus-Factor Analyzer
- * Analyzes code ownership concentration by examining git commit history.
- * Usage: node scripts/bus-factor.js [--json] [--min-commits N] [--threshold N] [--top N]
- */
-
-import { execSync } from 'child_process';
-import { fileURLToPath } from 'url';
-import path from 'path';
-
-// --- Pure analysis functions (exported for testing) ---
-
-/**
- * Parse raw `git log --numstat` output into a map of file -> author -> commitCount.
- * @param {string} rawLog - Output from git log --numstat
- * @returns {Object} { [filePath]: { [author]: number } }
- */
-export function parseGitLog(rawLog) {
-  const ownership = {};
-  const lines = rawLog.split('\n');
-  let currentAuthor = null;
-
-  for (const line of lines) {
-    // Commit header line: "commit <hash>"
-    if (line.startsWith('commit ')) {
-      currentAuthor = null;
-      continue;
-    }
-
-    // Author line: "Author: Name <email>"
-    const authorMatch = line.match(/^Author:\s+(.+?)\s+<[^>]+>/);
-    if (authorMatch) {
-      currentAuthor = authorMatch[1].trim();
-      continue;
-    }
-
-    // Numstat line: "<added>\t<deleted>\t<filename>"
-    if (currentAuthor && /^\d+\t\d+\t/.test(line)) {
-      const parts = line.split('\t');
-      if (parts.length < 3) continue;
-
-      // Handle rename: "old/path => new/path" or "{old => new}/suffix"
-      let filePath = parts[2];
-      if (filePath.includes('{') && filePath.includes('=>')) {
-        filePath = filePath.replace(/\{([^}]*?)\s*=>\s*([^}]*?)\}/g, '$2').replace(/\s+/g, '');
-      } else if (filePath.includes(' => ')) {
-        filePath = filePath.split(' => ')[1].trim();
-      }
-
-      filePath = filePath.trim();
-      if (!filePath) continue;
-
-      if (!ownership[filePath]) ownership[filePath] = {};
-      ownership[filePath][currentAuthor] = (ownership[filePath][currentAuthor] || 0) + 1;
-    }
-  }
-
-  return ownership;
-}
-
-/**
- * Compute ownership metrics for a single file.
- * @param {Object} authorCounts - { [author]: commitCount }
- * @param {number} ownershipThreshold - min fraction to count toward bus-factor (default 0.1)
- * @returns {Object} { totalCommits, authors, busFactor, primaryOwner }
- */
-export function computeOwnership(authorCounts, ownershipThreshold = 0.1) {
-  const entries = Object.entries(authorCounts).sort((a, b) => b[1] - a[1]);
-  const totalCommits = entries.reduce((sum, [, n]) => sum + n, 0);
-
-  const authors = entries.map(([name, commits]) => ({
-    name,
-    commits,
-    pct: totalCommits > 0 ? commits / totalCommits : 0,
-  }));
-
-  const busFactor = authors.filter(a => a.pct >= ownershipThreshold).length;
-  const primaryOwner = authors[0] || null;
-
-  return { totalCommits, authors, busFactor, primaryOwner };
-}
-
-/**
- * Score all files and return sorted results.
- * @param {Object} ownership - Output from parseGitLog
- * @param {Object} options
- * @returns {Array} Sorted file entries with ownership metrics
- */
-export function scoreFiles(ownership, { minCommits = 2, ownershipThreshold = 0.1 } = {}) {
-  const results = [];
-
-  for (const [filePath, authorCounts] of Object.entries(ownership)) {
-    const metrics = computeOwnership(authorCounts, ownershipThreshold);
-    if (metrics.totalCommits < minCommits) continue;
-
-    results.push({ file: filePath, ...metrics });
-  }
-
-  // Sort: lowest bus-factor first, then most commits (highest risk first)
-  results.sort((a, b) => {
-    if (a.busFactor !== b.busFactor) return a.busFactor - b.busFactor;
-    return b.totalCommits - a.totalCommits;
-  });
-
-  return results;
-}
-
-/**
- * Compute overall repo stats (weighted average bus-factor, high-risk count).
- */
-export function repoStats(scoredFiles) {
-  if (scoredFiles.length === 0) return { avgBusFactor: 0, highRiskCount: 0, totalFiles: 0 };
-
-  const totalCommits = scoredFiles.reduce((s, f) => s + f.totalCommits, 0);
-  const weightedBf = scoredFiles.reduce((s, f) => s + f.busFactor * f.totalCommits, 0);
-  const avgBusFactor = totalCommits > 0 ? weightedBf / totalCommits : 0;
-  const highRiskCount = scoredFiles.filter(f => f.busFactor === 1).length;
-
-  return { avgBusFactor, highRiskCount, totalFiles: scoredFiles.length };
-}
-
-// --- CLI ---
-
-function collectGitLog(repoRoot) {
-  const dirs = ['server/src', 'client/src', 'db/migrations'];
-  const cmd = `git -C "${repoRoot}" log --numstat -- ${dirs.join(' ')}`;
-  return execSync(cmd, { maxBuffer: 50 * 1024 * 1024 }).toString();
-}
-
-function formatReport(scoredFiles, stats, topN = 10) {
-  const lines = [];
-  lines.push('');
-  lines.push('=== Bus-Factor Analysis ===');
-  lines.push('');
-  lines.push(`Files analyzed : ${stats.totalFiles}`);
-  lines.push(`High-risk files: ${stats.highRiskCount} (bus-factor = 1)`);
-  lines.push(`Avg bus-factor : ${stats.avgBusFactor.toFixed(2)} (weighted by commits)`);
-  lines.push('');
-
-  const highRisk = scoredFiles.filter(f => f.busFactor === 1);
-  if (highRisk.length === 0) {
-    lines.push('No high-risk files found.');
-  } else {
-    lines.push(`--- Top ${Math.min(topN, highRisk.length)} High-Risk Files (bus-factor = 1) ---`);
-    lines.push('');
-    for (const f of highRisk.slice(0, topN)) {
-      const owner = f.primaryOwner;
-      lines.push(`  ${f.file}`);
-      lines.push(`    commits: ${f.totalCommits}  owner: ${owner.name} (${(owner.pct * 100).toFixed(0)}%)`);
-      if (f.authors.length > 1) {
-        const others = f.authors.slice(1, 3).map(a => `${a.name} ${(a.pct * 100).toFixed(0)}%`).join(', ');
-        lines.push(`    others: ${others}`);
-      }
-      lines.push('');
-    }
-  }
-
-  lines.push('--- Author Contribution Summary ---');
-  lines.push('');
-  const authorTotals = {};
-  for (const f of scoredFiles) {
-    for (const a of f.authors) {
-      authorTotals[a.name] = (authorTotals[a.name] || 0) + a.commits;
-    }
-  }
-  const totalAll = Object.values(authorTotals).reduce((s, n) => s + n, 0);
-  const sorted = Object.entries(authorTotals).sort((a, b) => b[1] - a[1]);
-  for (const [name, commits] of sorted) {
-    const pct = totalAll > 0 ? (commits / totalAll * 100).toFixed(1) : '0.0';
-    lines.push(`  ${name.padEnd(30)} ${String(commits).padStart(5)} commits  (${pct}%)`);
-  }
-  lines.push('');
-
-  return lines.join('\n');
-}
-
-// Detect if running as main script (ESM equivalent of require.main === module)
-const isMain = process.argv[1] === fileURLToPath(import.meta.url);
-
-if (isMain) {
-  const args = process.argv.slice(2);
-  const jsonMode = args.includes('--json');
-
-  const minCommitsIdx = args.indexOf('--min-commits');
-  const minCommits = minCommitsIdx !== -1 ? parseInt(args[minCommitsIdx + 1], 10) : 2;
-
-  const thresholdIdx = args.indexOf('--threshold');
-  const threshold = thresholdIdx !== -1 ? parseFloat(args[thresholdIdx + 1]) : 0.1;
-
-  const topIdx = args.indexOf('--top');
-  const topN = topIdx !== -1 ? parseInt(args[topIdx + 1], 10) : 10;
-
-  const repoRoot = path.resolve(fileURLToPath(import.meta.url), '..', '..');
-
-  let rawLog;
-  try {
-    rawLog = collectGitLog(repoRoot);
-  } catch (err) {
-    process.stderr.write(`Error running git log: ${err.message}\n`);
-    process.exit(1);
-  }
-
-  const ownership = parseGitLog(rawLog);
-  const scoredFiles = scoreFiles(ownership, { minCommits, ownershipThreshold: threshold });
-  const stats = repoStats(scoredFiles);
-
-  if (jsonMode) {
-    process.stdout.write(JSON.stringify({ stats, files: scoredFiles }, null, 2) + '\n');
-  } else {
-    process.stdout.write(formatReport(scoredFiles, stats, topN));
-  }
-}
--- a/scripts/bus-factor.test.mjs
+++ b/scripts/bus-factor.test.mjs
@@ -1,202 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { parseGitLog, computeOwnership, scoreFiles, repoStats } from './bus-factor.mjs';
-
-// --- parseGitLog ---
-
-describe('parseGitLog', () => {
-  it('parses a single commit with one file', () => {
-    const raw = `commit abc123
-Author: Alice <alice@example.com>
-Date:   Mon Jan 1 00:00:00 2024
-
-    Initial commit
-
-5\t2\tserver/src/index.js
-`;
-    const result = parseGitLog(raw);
-    expect(result['server/src/index.js']).toEqual({ Alice: 1 });
-  });
-
-  it('accumulates multiple commits by the same author', () => {
-    const raw = `commit aaa
-Author: Alice <alice@example.com>
-Date:   Mon Jan 1 00:00:00 2024
-
-    First
-
-3\t0\tserver/src/app.js
-
-commit bbb
-Author: Alice <alice@example.com>
-Date:   Tue Jan 2 00:00:00 2024
-
-    Second
-
-1\t1\tserver/src/app.js
-`;
-    const result = parseGitLog(raw);
-    expect(result['server/src/app.js']['Alice']).toBe(2);
-  });
-
-  it('tracks multiple authors for the same file', () => {
-    const raw = `commit aaa
-Author: Alice <alice@example.com>
-Date:   Mon Jan 1 00:00:00 2024
-
-    Alice commit
-
-2\t0\tclient/src/App.jsx
-
-commit bbb
-Author: Bob <bob@example.com>
-Date:   Tue Jan 2 00:00:00 2024
-
-    Bob commit
-
-1\t0\tclient/src/App.jsx
-`;
-    const result = parseGitLog(raw);
-    expect(result['client/src/App.jsx']['Alice']).toBe(1);
-    expect(result['client/src/App.jsx']['Bob']).toBe(1);
-  });
-
-  it('handles multiple files per commit', () => {
-    const raw = `commit aaa
-Author: Alice <alice@example.com>
-Date:   Mon Jan 1 00:00:00 2024
-
-    Multi-file commit
-
-2\t0\tserver/src/a.js
-3\t1\tserver/src/b.js
-`;
-    const result = parseGitLog(raw);
-    expect(result['server/src/a.js']['Alice']).toBe(1);
-    expect(result['server/src/b.js']['Alice']).toBe(1);
-  });
-
-  it('handles rename syntax (old => new)', () => {
-    const raw = `commit aaa
-Author: Alice <alice@example.com>
-Date:   Mon Jan 1 00:00:00 2024
-
-    Rename
-
-2\t0\told/path.js => new/path.js
-`;
-    const result = parseGitLog(raw);
-    expect(result['new/path.js']).toBeDefined();
-    expect(result['old/path.js']).toBeUndefined();
-  });
-
-  it('returns empty object for empty log', () => {
-    expect(parseGitLog('')).toEqual({});
-  });
-});
-
-// --- computeOwnership ---
-
-describe('computeOwnership', () => {
-  it('computes bus-factor of 1 for a solo author', () => {
-    const result = computeOwnership({ Alice: 10 });
-    expect(result.busFactor).toBe(1);
-    expect(result.totalCommits).toBe(10);
-    expect(result.primaryOwner.name).toBe('Alice');
-    expect(result.primaryOwner.pct).toBe(1);
-  });
-
-  it('computes bus-factor of 2 when two authors each own >= 10%', () => {
-    const result = computeOwnership({ Alice: 8, Bob: 2 });
-    expect(result.busFactor).toBe(2);
-  });
-
-  it('does not count authors below the threshold', () => {
-    // Bob has 5% — below default 10% threshold
-    const result = computeOwnership({ Alice: 19, Bob: 1 });
-    expect(result.busFactor).toBe(1);
-  });
-
-  it('respects a custom ownership threshold', () => {
-    // With 20% threshold, Bob (10%) doesn't count
-    const result = computeOwnership({ Alice: 9, Bob: 1 }, 0.2);
-    expect(result.busFactor).toBe(1);
-  });
-
-  it('sorts authors by commit count descending', () => {
-    const result = computeOwnership({ Alice: 3, Bob: 7, Carol: 5 });
-    expect(result.authors[0].name).toBe('Bob');
-    expect(result.authors[1].name).toBe('Carol');
-    expect(result.authors[2].name).toBe('Alice');
-  });
-
-  it('handles empty author counts gracefully', () => {
-    const result = computeOwnership({});
-    expect(result.totalCommits).toBe(0);
-    expect(result.busFactor).toBe(0);
-    expect(result.primaryOwner).toBeNull();
-  });
-});
-
-// --- scoreFiles ---
-
-describe('scoreFiles', () => {
-  const ownership = {
-    'server/src/risk.js': { Alice: 9, Bob: 1 },       // bus-factor 1 (Bob < 10%)
-    'server/src/shared.js': { Alice: 5, Bob: 5 },      // bus-factor 2
-    'server/src/tiny.js': { Alice: 1 },                // below minCommits=2, filtered
-  };
-
-  it('filters files below minCommits', () => {
-    const results = scoreFiles(ownership, { minCommits: 2 });
-    expect(results.find(f => f.file === 'server/src/tiny.js')).toBeUndefined();
-  });
-
-  it('includes files at or above minCommits', () => {
-    const results = scoreFiles(ownership, { minCommits: 2 });
-    const files = results.map(f => f.file);
-    expect(files).toContain('server/src/risk.js');
-    expect(files).toContain('server/src/shared.js');
-  });
-
-  it('sorts lowest bus-factor first', () => {
-    const results = scoreFiles(ownership, { minCommits: 2 });
-    expect(results[0].file).toBe('server/src/risk.js');
-    expect(results[1].file).toBe('server/src/shared.js');
-  });
-
-  it('returns empty array for empty ownership', () => {
-    expect(scoreFiles({}, {})).toEqual([]);
-  });
-});
-
-// --- repoStats ---
-
-describe('repoStats', () => {
-  it('returns zeros for empty input', () => {
-    const stats = repoStats([]);
-    expect(stats.avgBusFactor).toBe(0);
-    expect(stats.highRiskCount).toBe(0);
-    expect(stats.totalFiles).toBe(0);
-  });
-
-  it('counts high-risk files (busFactor === 1)', () => {
-    const files = [
-      { busFactor: 1, totalCommits: 10, authors: [] },
-      { busFactor: 2, totalCommits: 5, authors: [] },
-      { busFactor: 1, totalCommits: 3, authors: [] },
-    ];
-    const stats = repoStats(files);
-    expect(stats.highRiskCount).toBe(2);
-    expect(stats.totalFiles).toBe(3);
-  });
-
-  it('computes weighted average bus-factor', () => {
-    const files = [
-      { busFactor: 1, totalCommits: 10, authors: [] },
-      { busFactor: 3, totalCommits: 10, authors: [] },
-    ];
-    const stats = repoStats(files);
-    // (1*10 + 3*10) / 20 = 2
-    expect(stats.avgBusFactor).toBe(2);
-  });
-});
--- a/scripts/commit-msg
+++ b/scripts/commit-msg
@@ -0,0 +1,4 @@
+#!/bin/sh
+# Git commit-msg hook — delegates to normalize-commit-msg.js
+# This file is symlinked into .git/hooks/commit-msg by scripts/install-hooks.sh
+node "$(git rev-parse --show-toplevel)/scripts/normalize-commit-msg.js" "$1"
--- a/scripts/install-hooks.sh
+++ b/scripts/install-hooks.sh
@@ -0,0 +1,34 @@
+#!/bin/sh
+# install-hooks.sh
+# Installs the project's git hooks into .git/hooks/.
+# Run this once after cloning: sh scripts/install-hooks.sh
+
+set -e
+
+REPO_ROOT="$(git rev-parse --show-toplevel)"
+HOOKS_DIR="$REPO_ROOT/.git/hooks"
+SCRIPTS_DIR="$REPO_ROOT/scripts"
+
+install_hook() {
+  local name="$1"
+  local src="$SCRIPTS_DIR/$name"
+  local dst="$HOOKS_DIR/$name"
+
+  if [ ! -f "$src" ]; then
+    echo "install-hooks: source not found: $src" >&2
+    return 1
+  fi
+
+  if [ -f "$dst" ] && [ ! -L "$dst" ]; then
+    echo "install-hooks: warning: $dst already exists and is not a symlink — skipping"
+    return 0
+  fi
+
+  ln -sf "$src" "$dst"
+  chmod +x "$src"
+  echo "install-hooks: installed $name -> $dst"
+}
+
+install_hook "commit-msg"
+
+echo "install-hooks: done"
--- a/scripts/normalize-commit-msg.js
+++ b/scripts/normalize-commit-msg.js
@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+/**
+ * normalize-commit-msg.js
+ *
+ * Git commit-msg hook: reads the commit message file, applies normalization
+ * rules to the subject line, rewrites the file in place.
+ *
+ * Rules:
+ *   1. Trim leading/trailing whitespace from the subject line
+ *   2. Capitalize the first letter of the subject
+ *   3. Strip a trailing period from the subject
+ *   4. Warn (but do not block) if the subject exceeds 72 characters
+ */
+
+'use strict';
+
+const fs = require('fs');
+
+const MAX_SUBJECT_LEN = 72;
+
+/**
+ * Normalize the subject line of a commit message.
+ * Returns { subject, warned } where warned is true if a length warning was emitted.
+ *
+ * @param {string} subject
+ * @returns {{ subject: string, warned: boolean }}
+ */
+function normalizeSubject(subject) {
+  let s = subject.trimEnd();
+
+  // Trim leading whitespace
+  s = s.trimStart();
+
+  // Capitalize first letter
+  if (s.length > 0) {
+    s = s[0].toUpperCase() + s.slice(1);
+  }
+
+  // Strip trailing period
+  if (s.endsWith('.')) {
+    s = s.slice(0, -1);
+  }
+
+  const warned = s.length > MAX_SUBJECT_LEN;
+
+  return { subject: s, warned };
+}
+
+/**
+ * Normalize a full commit message string.
+ * Only the subject line (first non-empty, non-comment line) is modified.
+ *
+ * @param {string} message
+ * @returns {{ message: string, warned: boolean }}
+ */
+function normalizeMessage(message) {
+  const lines = message.split('\n');
+  let warned = false;
+
+  // Find the subject line (first non-comment line)
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (!line.startsWith('#')) {
+      const result = normalizeSubject(line);
+      lines[i] = result.subject;
+      warned = result.warned;
+      break;
+    }
+  }
+
+  return { message: lines.join('\n'), warned };
+}
+
+// Only run as a hook when invoked directly (not when required in tests)
+if (require.main === module) {
+  const msgFile = process.argv[2];
+  if (!msgFile) {
+    process.stderr.write('commit-msg hook: no message file argument\n');
+    process.exit(1);
+  }
+
+  const original = fs.readFileSync(msgFile, 'utf8');
+  const { message, warned } = normalizeMessage(original);
+
+  if (warned) {
+    process.stderr.write(
+      `commit-msg warning: subject line exceeds ${MAX_SUBJECT_LEN} characters — consider shortening it.\n`
+    );
+  }
+
+  fs.writeFileSync(msgFile, message, 'utf8');
+  process.exit(0);
+}
+
+module.exports = { normalizeSubject, normalizeMessage };
--- a/scripts/package-lock.json
+++ b/scripts/package-lock.json
@@ -47,6 +47,8 @@
    },
    "node_modules/@jridgewell/sourcemap-codec": {
      "version": "1.5.5",
+      "resolved": "https://registry.npmjs.org/@jridgewell/sourcemap-codec/-/sourcemap-codec-1.5.5.tgz",
+      "integrity": "sha512-cYQ9310grqxueWbl+WuIUIaiUaDcj7WOq5fVhEljNVgRfOUhY9fy2zTvfoqWsnebh8Sl70VScFbICvJnLKB0Og==",
      "dev": true,
      "license": "MIT"
    },
@@ -69,6 +71,8 @@
    },
    "node_modules/@oxc-project/types": {
      "version": "0.120.0",
+      "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.120.0.tgz",
+      "integrity": "sha512-k1YNu55DuvAip/MGE1FTsIuU3FUCn6v/ujG9V7Nq5Df/kX2CWb13hhwD0lmJGMGqE+bE1MXvv9SZVnMzEXlWcg==",
      "dev": true,
      "license": "MIT",
      "funding": {
@@ -230,6 +234,8 @@
    },
    "node_modules/@rolldown/binding-linux-x64-gnu": {
      "version": "1.0.0-rc.10",
+      "resolved": "https://registry.npmjs.org/@rolldown/binding-linux-x64-gnu/-/binding-linux-x64-gnu-1.0.0-rc.10.tgz",
+      "integrity": "sha512-eOCKUpluKgfObT2pHjztnaWEIbUabWzk3qPZ5PuacuPmr4+JtQG4k2vGTY0H15edaTnicgU428XW/IH6AimcQw==",
      "cpu": [
        "x64"
      ],
@@ -330,11 +336,15 @@
    },
    "node_modules/@rolldown/pluginutils": {
      "version": "1.0.0-rc.10",
+      "resolved": "https://registry.npmjs.org/@rolldown/pluginutils/-/pluginutils-1.0.0-rc.10.tgz",
+      "integrity": "sha512-UkVDEFk1w3mveXeKgaTuYfKWtPbvgck1dT8TUG3bnccrH0XtLTuAyfCoks4Q/M5ZGToSVJTIQYCzy2g/atAOeg==",
      "dev": true,
      "license": "MIT"
    },
    "node_modules/@standard-schema/spec": {
      "version": "1.1.0",
+      "resolved": "https://registry.npmjs.org/@standard-schema/spec/-/spec-1.1.0.tgz",
+      "integrity": "sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==",
      "dev": true,
      "license": "MIT"
    },
@@ -351,6 +361,8 @@
    },
    "node_modules/@types/chai": {
      "version": "5.2.3",
+      "resolved": "https://registry.npmjs.org/@types/chai/-/chai-5.2.3.tgz",
+      "integrity": "sha512-Mw558oeA9fFbv65/y4mHtXDs9bPnFMZAL/jxdPFUpOHHIXX91mcgEHbS5Lahr+pwZFR8A7GQleRWeI6cGFC2UA==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
@@ -360,16 +372,22 @@
    },
    "node_modules/@types/deep-eql": {
      "version": "4.0.2",
+      "resolved": "https://registry.npmjs.org/@types/deep-eql/-/deep-eql-4.0.2.tgz",
+      "integrity": "sha512-c9h9dVVMigMPc4bwTvC5dxqtqJZwQPePsWjPlpSOnojbor6pGqdk541lfA7AqFQr5pB1BRdq0juY9db81BwyFw==",
      "dev": true,
      "license": "MIT"
    },
    "node_modules/@types/estree": {
      "version": "1.0.8",
+      "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz",
+      "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==",
      "dev": true,
      "license": "MIT"
    },
    "node_modules/@vitest/expect": {
      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/@vitest/expect/-/expect-4.1.0.tgz",
+      "integrity": "sha512-EIxG7k4wlWweuCLG9Y5InKFwpMEOyrMb6ZJ1ihYu02LVj/bzUwn2VMU+13PinsjRW75XnITeFrQBMH5+dLvCDA==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
@@ -386,6 +404,8 @@
    },
    "node_modules/@vitest/mocker": {
      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/@vitest/mocker/-/mocker-4.1.0.tgz",
+      "integrity": "sha512-evxREh+Hork43+Y4IOhTo+h5lGmVRyjqI739Rz4RlUPqwrkFFDF6EMvOOYjTx4E8Tl6gyCLRL8Mu7Ry12a13Tw==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
@@ -411,6 +431,8 @@
    },
    "node_modules/@vitest/pretty-format": {
      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/@vitest/pretty-format/-/pretty-format-4.1.0.tgz",
+      "integrity": "sha512-3RZLZlh88Ib0J7NQTRATfc/3ZPOnSUn2uDBUoGNn5T36+bALixmzphN26OUD3LRXWkJu4H0s5vvUeqBiw+kS0A==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
@@ -422,6 +444,8 @@
    },
    "node_modules/@vitest/runner": {
      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/@vitest/runner/-/runner-4.1.0.tgz",
+      "integrity": "sha512-Duvx2OzQ7d6OjchL+trw+aSrb9idh7pnNfxrklo14p3zmNL4qPCDeIJAK+eBKYjkIwG96Bc6vYuxhqDXQOWpoQ==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
@@ -434,6 +458,8 @@
    },
    "node_modules/@vitest/snapshot": {
      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/@vitest/snapshot/-/snapshot-4.1.0.tgz",
+      "integrity": "sha512-0Vy9euT1kgsnj1CHttwi9i9o+4rRLEaPRSOJ5gyv579GJkNpgJK+B4HSv/rAWixx2wdAFci1X4CEPjiu2bXIMg==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
@@ -448,6 +474,8 @@
    },
    "node_modules/@vitest/spy": {
      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/@vitest/spy/-/spy-4.1.0.tgz",
+      "integrity": "sha512-pz77k+PgNpyMDv2FV6qmk5ZVau6c3R8HC8v342T2xlFxQKTrSeYw9waIJG8KgV9fFwAtTu4ceRzMivPTH6wSxw==",
      "dev": true,
      "license": "MIT",
      "funding": {
@@ -456,6 +484,8 @@
    },
    "node_modules/@vitest/utils": {
      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/@vitest/utils/-/utils-4.1.0.tgz",
+      "integrity": "sha512-XfPXT6a8TZY3dcGY8EdwsBulFCIw+BeeX0RZn2x/BtiY/75YGh8FeWGG8QISN/WhaqSrE2OrlDgtF8q5uhOTmw==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
@@ -469,6 +499,8 @@
    },
    "node_modules/assertion-error": {
      "version": "2.0.1",
+      "resolved": "https://registry.npmjs.org/assertion-error/-/assertion-error-2.0.1.tgz",
+      "integrity": "sha512-Izi8RQcffqCeNVgFigKli1ssklIbpHnCYc6AknXGYoB6grJqyeby7jv12JUQgmTAnIDnbck1uxksT4dzN3PWBA==",
      "dev": true,
      "license": "MIT",
      "engines": {
@@ -477,6 +509,8 @@
    },
    "node_modules/chai": {
      "version": "6.2.2",
+      "resolved": "https://registry.npmjs.org/chai/-/chai-6.2.2.tgz",
+      "integrity": "sha512-NUPRluOfOiTKBKvWPtSD4PhFvWCqOi0BGStNWs57X9js7XGTprSmFoz5F0tWhR4WPjNeR9jXqdC7/UpSJTnlRg==",
      "dev": true,
      "license": "MIT",
      "engines": {
@@ -485,11 +519,15 @@
    },
    "node_modules/convert-source-map": {
      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/convert-source-map/-/convert-source-map-2.0.0.tgz",
+      "integrity": "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg==",
      "dev": true,
      "license": "MIT"
    },
    "node_modules/detect-libc": {
      "version": "2.1.2",
+      "resolved": "https://registry.npmjs.org/detect-libc/-/detect-libc-2.1.2.tgz",
+      "integrity": "sha512-Btj2BOOO83o3WyH59e8MgXsxEQVcarkUOpEYrubB0urwnN10yQ364rsiByU11nZlqWYZm05i/of7io4mzihBtQ==",
      "dev": true,
      "license": "Apache-2.0",
      "engines": {
@@ -498,11 +536,15 @@
    },
    "node_modules/es-module-lexer": {
      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/es-module-lexer/-/es-module-lexer-2.0.0.tgz",
+      "integrity": "sha512-5POEcUuZybH7IdmGsD8wlf0AI55wMecM9rVBTI/qEAy2c1kTOm3DjFYjrBdI2K3BaJjJYfYFeRtM0t9ssnRuxw==",
      "dev": true,
      "license": "MIT"
    },
    "node_modules/estree-walker": {
      "version": "3.0.3",
+      "resolved": "https://registry.npmjs.org/estree-walker/-/estree-walker-3.0.3.tgz",
+      "integrity": "sha512-7RUKfXgSMMkzt6ZuXmqapOurLGPPfgj6l9uRZ7lRGolvk0y2yocc35LdcxKC5PQZdn2DMqioAQ2NoWcrTKmm6g==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
@@ -511,6 +553,8 @@
    },
    "node_modules/expect-type": {
      "version": "1.3.0",
+      "resolved": "https://registry.npmjs.org/expect-type/-/expect-type-1.3.0.tgz",
+      "integrity": "sha512-knvyeauYhqjOYvQ66MznSMs83wmHrCycNEN6Ao+2AeYEfxUIkuiVxdEa1qlGEPK+We3n0THiDciYSsCcgW/DoA==",
      "dev": true,
      "license": "Apache-2.0",
      "engines": {
@@ -519,6 +563,8 @@
    },
    "node_modules/fdir": {
      "version": "6.5.0",
+      "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz",
+      "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==",
      "dev": true,
      "license": "MIT",
      "engines": {
@@ -550,6 +596,8 @@
    },
    "node_modules/lightningcss": {
      "version": "1.32.0",
+      "resolved": "https://registry.npmjs.org/lightningcss/-/lightningcss-1.32.0.tgz",
+      "integrity": "sha512-NXYBzinNrblfraPGyrbPoD19C1h9lfI/1mzgWYvXUTe414Gz/X1FD2XBZSZM7rRTrMA8JL3OtAaGifrIKhQ5yQ==",
      "dev": true,
      "license": "MPL-2.0",
      "dependencies": {
@@ -725,6 +773,8 @@
    },
    "node_modules/lightningcss-linux-x64-gnu": {
      "version": "1.32.0",
+      "resolved": "https://registry.npmjs.org/lightningcss-linux-x64-gnu/-/lightningcss-linux-x64-gnu-1.32.0.tgz",
+      "integrity": "sha512-V7Qr52IhZmdKPVr+Vtw8o+WLsQJYCTd8loIfpDaMRWGUZfBOYEJeyJIkqGIDMZPwPx24pUMfwSxxI8phr/MbOA==",
      "cpu": [
        "x64"
      ],
@@ -807,6 +857,8 @@
    },
    "node_modules/magic-string": {
      "version": "0.30.21",
+      "resolved": "https://registry.npmjs.org/magic-string/-/magic-string-0.30.21.tgz",
+      "integrity": "sha512-vd2F4YUyEXKGcLHoq+TEyCjxueSeHnFxyyjNp80yg0XV4vUhnDer/lvvlqM/arB5bXQN5K2/3oinyCRyx8T2CQ==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
@@ -815,6 +867,8 @@
    },
    "node_modules/nanoid": {
      "version": "3.3.11",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz",
+      "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==",
      "dev": true,
      "funding": [
        {
@@ -832,6 +886,8 @@
    },
    "node_modules/obug": {
      "version": "2.1.1",
+      "resolved": "https://registry.npmjs.org/obug/-/obug-2.1.1.tgz",
+      "integrity": "sha512-uTqF9MuPraAQ+IsnPf366RG4cP9RtUi7MLO1N3KEc+wb0a6yKpeL0lmk2IB1jY5KHPAlTc6T/JRdC/YqxHNwkQ==",
      "dev": true,
      "funding": [
        "https://github.com/sponsors/sxzz",
@@ -841,16 +897,22 @@
    },
    "node_modules/pathe": {
      "version": "2.0.3",
+      "resolved": "https://registry.npmjs.org/pathe/-/pathe-2.0.3.tgz",
+      "integrity": "sha512-WUjGcAqP1gQacoQe+OBJsFA7Ld4DyXuUIjZ5cc75cLHvJ7dtNsTugphxIADwspS+AraAUePCKrSVtPLFj/F88w==",
      "dev": true,
      "license": "MIT"
    },
    "node_modules/picocolors": {
      "version": "1.1.1",
+      "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz",
+      "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==",
      "dev": true,
      "license": "ISC"
    },
    "node_modules/picomatch": {
      "version": "4.0.3",
+      "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz",
+      "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==",
      "dev": true,
      "license": "MIT",
      "engines": {
@@ -862,6 +924,8 @@
    },
    "node_modules/postcss": {
      "version": "8.5.8",
+      "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.8.tgz",
+      "integrity": "sha512-OW/rX8O/jXnm82Ey1k44pObPtdblfiuWnrd8X7GJ7emImCOstunGbXUpp7HdBrFQX6rJzn3sPT397Wp5aCwCHg==",
      "dev": true,
      "funding": [
        {
@@ -889,6 +953,8 @@
    },
    "node_modules/rolldown": {
      "version": "1.0.0-rc.10",
+      "resolved": "https://registry.npmjs.org/rolldown/-/rolldown-1.0.0-rc.10.tgz",
+      "integrity": "sha512-q7j6vvarRFmKpgJUT8HCAUljkgzEp4LAhPlJUvQhA5LA1SUL36s5QCysMutErzL3EbNOZOkoziSx9iZC4FddKA==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
@@ -921,11 +987,15 @@
    },
    "node_modules/siginfo": {
      "version": "2.0.0",
+      "resolved": "https://registry.npmjs.org/siginfo/-/siginfo-2.0.0.tgz",
+      "integrity": "sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==",
      "dev": true,
      "license": "ISC"
    },
    "node_modules/source-map-js": {
      "version": "1.2.1",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
+      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
      "dev": true,
      "license": "BSD-3-Clause",
      "engines": {
@@ -934,21 +1004,29 @@
    },
    "node_modules/stackback": {
      "version": "0.0.2",
+      "resolved": "https://registry.npmjs.org/stackback/-/stackback-0.0.2.tgz",
+      "integrity": "sha512-1XMJE5fQo1jGH6Y/7ebnwPOBEkIEnT4QF32d5R1+VXdXveM0IBMJt8zfaxX1P3QhVwrYe+576+jkANtSS2mBbw==",
      "dev": true,
      "license": "MIT"
    },
    "node_modules/std-env": {
      "version": "4.0.0",
+      "resolved": "https://registry.npmjs.org/std-env/-/std-env-4.0.0.tgz",
+      "integrity": "sha512-zUMPtQ/HBY3/50VbpkupYHbRroTRZJPRLvreamgErJVys0ceuzMkD44J/QjqhHjOzK42GQ3QZIeFG1OYfOtKqQ==",
      "dev": true,
      "license": "MIT"
    },
    "node_modules/tinybench": {
      "version": "2.9.0",
+      "resolved": "https://registry.npmjs.org/tinybench/-/tinybench-2.9.0.tgz",
+      "integrity": "sha512-0+DUvqWMValLmha6lr4kD8iAMK1HzV0/aKnCtWb9v9641TnP/MFb7Pc2bxoxQjTXAErryXVgUOfv2YqNllqGeg==",
      "dev": true,
      "license": "MIT"
    },
    "node_modules/tinyexec": {
      "version": "1.0.4",
+      "resolved": "https://registry.npmjs.org/tinyexec/-/tinyexec-1.0.4.tgz",
+      "integrity": "sha512-u9r3uZC0bdpGOXtlxUIdwf9pkmvhqJdrVCH9fapQtgy/OeTTMZ1nqH7agtvEfmGui6e1XxjcdrlxvxJvc3sMqw==",
      "dev": true,
      "license": "MIT",
      "engines": {
@@ -957,6 +1035,8 @@
    },
    "node_modules/tinyglobby": {
      "version": "0.2.15",
+      "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz",
+      "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
@@ -972,6 +1052,8 @@
    },
    "node_modules/tinyrainbow": {
      "version": "3.1.0",
+      "resolved": "https://registry.npmjs.org/tinyrainbow/-/tinyrainbow-3.1.0.tgz",
+      "integrity": "sha512-Bf+ILmBgretUrdJxzXM0SgXLZ3XfiaUuOj/IKQHuTXip+05Xn+uyEYdVg0kYDipTBcLrCVyUzAPz7QmArb0mmw==",
      "dev": true,
      "license": "MIT",
      "engines": {
@@ -988,6 +1070,8 @@
    },
    "node_modules/vite": {
      "version": "8.0.1",
+      "resolved": "https://registry.npmjs.org/vite/-/vite-8.0.1.tgz",
+      "integrity": "sha512-wt+Z2qIhfFt85uiyRt5LPU4oVEJBXj8hZNWKeqFG4gRG/0RaRGJ7njQCwzFVjO+v4+Ipmf5CY7VdmZRAYYBPHw==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
@@ -1064,6 +1148,8 @@
    },
    "node_modules/vitest": {
      "version": "4.1.0",
+      "resolved": "https://registry.npmjs.org/vitest/-/vitest-4.1.0.tgz",
+      "integrity": "sha512-YbDrMF9jM2Lqc++2530UourxZHmkKLxrs4+mYhEwqWS97WJ7wOYEkcr+QfRgJ3PW9wz3odRijLZjHEaRLTNbqw==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
@@ -1144,6 +1230,8 @@
    },
    "node_modules/why-is-node-running": {
      "version": "2.3.0",
+      "resolved": "https://registry.npmjs.org/why-is-node-running/-/why-is-node-running-2.3.0.tgz",
+      "integrity": "sha512-hUrmaWBdVDcxvYqnyh09zunKzROWjbZTiNy8dBEjkS7ehEDQibXJ7XvlmtbwuTclUiIyN+CyXQD4Vmko8fNm8w==",
      "dev": true,
      "license": "MIT",
      "dependencies": {
--- a/scripts/package.json
+++ b/scripts/package.json
@@ -4,7 +4,7 @@
  "scripts": {
    "test": "vitest run",
    "test:watch": "vitest",
-    "bus-factor": "node bus-factor.mjs"
+    "hooks:install": "sh install-hooks.sh"
  },
  "devDependencies": {
    "vitest": "^4.1.0"
--- a/scripts/vitest.config.mjs
+++ b/scripts/vitest.config.mjs
@@ -1,8 +0,0 @@
-import { defineConfig } from 'vitest/config';
-
-export default defineConfig({
-  test: {
-    globals: true,
-    environment: 'node',
-  },
-});