gitverse-release 3.3.0 → 3.3.2

package/README.md

@@ -15,6 +15,8 @@
 - 🏷️ **Автоматические git теги и коммиты**
 - 🔍 **Режим dry-run** для безопасного тестирования
 - ⚙️ **Гибкая конфигурация** через `.gitversereleaserc.json`
+- 🔧 **Автогенерация commitlint конфига** из release конфигурации
+- 🪝 **Хуки beforeCommit** для автоматической подготовки файлов перед релизом
 
 ## Установка
 
@@ -224,6 +226,88 @@ git commit -m "fix(ui): исправлена ошибка компонента"
 git commit -m "chore: обновлены зависимости"
 ```
 
+## Генерация Commitlint конфига
+
+Инструмент может автоматически генерировать `commitlint.config.ts` из вашей release конфигурации, обеспечивая синхронизацию между форматом коммитов и генерацией релизов.
+
+### Быстрый старт
+
+```bash
+# Генерировать commitlint конфиг
+npx gitverse-release generate-commitlint
+
+# Preview без записи файла
+npx gitverse-release generate-commitlint --dry-run
+
+# С кастомными параметрами
+npx gitverse-release generate-commitlint --format js --output .commitlintrc.js
+```
+
+### Что генерируется?
+
+Команда автоматически извлекает:
+- **Типы коммитов** из `changelog.types` (feat, fix, docs, etc.)
+- **Scopes** из названий пакетов в монорепо + дополнительные scopes
+- **Правила валидации** (max length, case, required fields)
+
+### Конфигурация defaults
+
+Добавьте секцию `commitlint` в `.gitversereleaserc.json`:
+
+```json
+{
+  "commitlint": {
+    "output": "commitlint.config.ts",
+    "format": "ts",
+    "scopes": ["deps", "ci", "docs"],
+    "scopeRequired": false,
+    "headerMaxLength": 100,
+    "comments": true
+  }
+}
+```
+
+Теперь можно просто запускать `npx gitverse-release generate-commitlint` без параметров!
+
+### CLI опции
+
+```bash
+--output <path>          Путь для вывода (default: из конфига)
+--format <ts|js|json>    Формат файла (default: из конфига)
+--scopes <list>          Дополнительные scopes через запятую
+--scope-required         Требовать обязательный scope
+--header-max-length <n>  Максимальная длина header
+--no-comments            Отключить комментарии в файле
+--dry-run                Preview без записи
+--verbose                Подробный вывод
+```
+
+### Примеры использования
+
+```bash
+# Использовать настройки из конфига
+npx gitverse-release generate-commitlint
+
+# Preview сгенерированного файла
+npx gitverse-release generate-commitlint --dry-run --verbose
+
+# Генерировать JS вместо TS
+npx gitverse-release generate-commitlint --format js --output .commitlintrc.js
+
+# Добавить дополнительные scopes
+npx gitverse-release generate-commitlint --scopes api,cli,tests
+
+# Требовать обязательный scope
+npx gitverse-release generate-commitlint --scope-required
+```
+
+### Преимущества
+
+✅ **Единый источник истины** - типы и scopes определяются в одном месте
+✅ **Автоматическая синхронизация** - изменения в release конфиге автоматически отражаются в commitlint
+✅ **Меньше ошибок** - нет риска рассинхронизации конфигов
+✅ **CI-friendly** - легко интегрируется в pipelines для проверки актуальности конфига
+
 ## Конфигурация
 
 ### Полный пример
@@ -231,6 +315,7 @@ git commit -m "chore: обновлены зависимости"
 ```json
 {
   "git": {
+    "beforeCommit": "bun run lint:fix",
     "commitMessage": "chore(release): v{version} [skip ci]",
     "tagMessage": "Release {version}",
     "push": true,
@@ -265,10 +350,54 @@ git commit -m "chore: обновлены зависимости"
   "monorepo": {
     "enabled": false,
     "packages": []
+  },
+  "commitlint": {
+    "output": "commitlint.config.ts",
+    "format": "ts",
+    "scopes": ["deps", "ci", "docs"],
+    "scopeRequired": false,
+    "headerMaxLength": 100,
+    "comments": true
+  }
+}
+```
+
+### beforeCommit хук
+
+Хук `beforeCommit` запускается **перед проверкой чистоты working tree** и позволяет автоматически подготовить файлы перед созданием релиза:
+
+```json
+{
+  "git": {
+    "beforeCommit": "bun run lint:fix"
   }
 }
 ```
 
+**Как это работает:**
+1. Запускается команда `beforeCommit` (например, линтер)
+2. Если команда выполнилась успешно (exit code 0):
+   - Все измененные файлы добавляются в staging area (`git add -A`)
+   - Эти изменения войдут в коммит релиза вместе с version/changelog
+3. Проверяется чистота working tree (только unstaged изменения)
+
+**Примеры использования:**
+```json
+// Форматирование кода
+"beforeCommit": "bun run format"
+
+// Линтинг и автофикс
+"beforeCommit": "bun run lint:fix"
+
+// Обновление lock файлов
+"beforeCommit": "bun install --frozen-lockfile=false"
+
+// Несколько команд
+"beforeCommit": "bun run lint:fix && bun run format"
+```
+
+**Важно:** Если хук завершается с ошибкой (exit code ≠ 0), изменения НЕ добавляются в staging area и релиз продолжается как обычно.
+
 ### Переменные окружения
 
 ```bash
@@ -332,19 +461,53 @@ env:
 
 ## CLI опции
 
-```
+### Основные команды
+
+```bash
+# Создать релиз
 npx gitverse-release [package] [options]
 
+# Генерировать commitlint конфиг
+npx gitverse-release generate-commitlint [options]
+
+# Создать только GitVerse Release для существующего тега (recovery mode)
+npx gitverse-release create-only --tag <tag> [--package <name>]
+```
+
+### Опции для релиза
+
+```
 Аргументы:
   package              Имя пакета для релиза (для монорепозиториев)
 
 Опции:
   --dry-run            Запуск без внесения изменений
+  --config <path>      Путь к конфиг файлу (default: .gitversereleaserc.json)
+  --package <name>     Имя пакета для релиза (для монорепо)
   --version <version>  Указать конкретную версию
-  --skip-git-check     Пропустить проверку git статуса
+  --prerelease [tag]   Создать prerelease версию (beta, alpha, rc)
+  --no-commit          Не создавать git коммит
+  --no-tag             Не создавать git тег
+  --no-push            Не пушить в remote
+  --no-release         Не создавать GitVerse Release
+  --verbose            Подробный вывод
   --help               Показать справку
 ```
 
+### Опции для generate-commitlint
+
+```
+Опции:
+  --output <path>            Путь для вывода (default: commitlint.config.ts)
+  --format <ts|js|json>      Формат файла (default: ts)
+  --scopes <scopes>          Дополнительные scopes (comma-separated)
+  --scope-required           Требовать обязательный scope
+  --header-max-length <n>    Максимальная длина header (default: 100)
+  --no-comments              Отключить комментарии в файле
+  --dry-run                  Preview без записи
+  --verbose                  Подробный вывод
+```
+
 ## CI/CD интеграция
 
 ### GitVerse Actions

package/dist/cli.js

@@ -601,9 +601,9 @@ class q3 {
 }
 
 // ../sdk/dist/client.js
-var F = { DELETE: "DELETE", GET: "GET", PATCH: "PATCH", POST: "POST", PUT: "PUT" };
+var J2 = { DELETE: "DELETE", GET: "GET", PATCH: "PATCH", POST: "POST", PUT: "PUT" };
 
-class _ {
+class $ {
   baseUrl;
   token;
   apiVersion;
@@ -615,10 +615,11 @@ class _ {
     this.token = j5;
   }
   extractRateLimitInfo(j5) {
-    let x2 = j5.get("GitVerse-RateLimit-Limit"), q4 = j5.get("GitVerse-RateLimit-Remaining"), z2 = j5.get("GitVerse-RateLimit-Retry-After"), B2 = j5.get("Gitverse-Ratelimit-Reset");
-    if (!(x2 && q4 && z2 && B2))
+    let x2 = j5.get("GitVerse-RateLimit-Limit"), q4 = j5.get("GitVerse-RateLimit-User-Remaining") || j5.get("GitVerse-RateLimit-Remaining"), z2 = j5.get("GitVerse-RateLimit-Retry-After"), B2 = j5.get("Gitverse-Ratelimit-Reset");
+    if (!(x2 && z2))
       return;
-    return { limit: Number.parseInt(x2, 10), remaining: Number.parseInt(q4, 10), reset: Number.parseInt(B2, 10), retryAfter: Number.parseInt(z2, 10) };
+    let K = Number.parseInt(z2, 10), D = B2 ? Number.parseInt(B2, 10) : Math.floor(Date.now() / 1000) + K, U = q4 ? Number.parseInt(q4, 10) : 0;
+    return { limit: Number.parseInt(x2, 10), remaining: U, reset: D, retryAfter: K };
   }
   extractApiVersionInfo(j5) {
     let x2 = j5.get("Gitverse-Api-Version"), q4 = j5.get("Gitverse-Api-Latest-Version"), z2 = j5.get("Gitverse-Api-Deprecation") === "true", B2 = j5.get("Gitverse-Api-Decommissioning");
@@ -635,37 +636,37 @@ class _ {
     return { apiVersion: q4, rateLimit: x2 };
   }
   async request(j5, x2, q4, z2) {
-    let B2 = j5.startsWith("/") ? j5.slice(1) : j5, Y = `${this.baseUrl}/${B2}`, J2 = new Headers;
-    if (J2.set("Content-Type", "application/json"), J2.set("Accept", `application/vnd.gitverse.object+json; version=${this.apiVersion}`), this.token)
-      J2.set("Authorization", `Bearer ${this.token}`);
-    let Z = { body: q4 ? JSON.stringify(q4) : undefined, headers: J2, method: x2, signal: z2?.signal }, D = await fetch(Y, Z), K = this.extractMetadata(D.headers), N;
+    let B2 = j5.startsWith("/") ? j5.slice(1) : j5, K = `${this.baseUrl}/${B2}`, D = new Headers;
+    if (D.set("Content-Type", "application/json"), D.set("Accept", `application/vnd.gitverse.object+json; version=${this.apiVersion}`), this.token)
+      D.set("Authorization", `Bearer ${this.token}`);
+    let U = { body: q4 ? JSON.stringify(q4) : undefined, headers: D, method: x2, signal: z2?.signal }, F = await fetch(K, U), Q = this.extractMetadata(F.headers), S;
     try {
-      N = await D.json();
+      S = await F.json();
     } catch {
-      N = undefined;
+      S = undefined;
     }
-    if (!D.ok) {
-      let Q = N?.message || D.statusText;
-      if (D.status === 429 && K.rateLimit)
-        throw new k2(Q || "Превышен лимит запросов. Попробуйте позже.", K.rateLimit, K);
-      throw new j2(D.status, Q, K);
+    if (!F.ok) {
+      let X = S?.message || F.statusText;
+      if (F.status === 429 && Q.rateLimit)
+        throw new k2(X || "Превышен лимит запросов. Попробуйте позже.", Q.rateLimit, Q);
+      throw new j2(F.status, X, Q);
     }
-    return N;
+    return S;
   }
   get(j5, x2) {
-    return this.request(j5, F.GET, undefined, x2);
+    return this.request(j5, J2.GET, undefined, x2);
   }
   post(j5, x2, q4) {
-    return this.request(j5, F.POST, x2, q4);
+    return this.request(j5, J2.POST, x2, q4);
   }
   put(j5, x2, q4) {
-    return this.request(j5, F.PUT, x2, q4);
+    return this.request(j5, J2.PUT, x2, q4);
   }
   delete(j5, x2, q4) {
-    return this.request(j5, F.DELETE, x2, q4);
+    return this.request(j5, J2.DELETE, x2, q4);
   }
   patch(j5, x2, q4) {
-    return this.request(j5, F.PATCH, x2, q4);
+    return this.request(j5, J2.PATCH, x2, q4);
   }
 }
 
@@ -720,7 +721,7 @@ class Z {
   git;
   actions;
   constructor(d2 = {}) {
-    this.client = new _(d2), this.users = new f(this.client), this.repos = new A(this.client), this.contents = new k4(this.client), this.pulls = new y(this.client), this.forks = new q3(this.client), this.emails = new d(this.client), this.issues = new B(this.client), this.stars = new k3(this.client), this.branches = new g(this.client), this.commits = new j(this.client), this.collaborators = new j3(this.client), this.organizations = new k(this.client), this.teams = new k5(this.client), this.releases = new q2(this.client), this.git = new j4(this.client), this.actions = new x(this.client);
+    this.client = new $(d2), this.users = new f(this.client), this.repos = new A(this.client), this.contents = new k4(this.client), this.pulls = new y(this.client), this.forks = new q3(this.client), this.emails = new d(this.client), this.issues = new B(this.client), this.stars = new k3(this.client), this.branches = new g(this.client), this.commits = new j(this.client), this.collaborators = new j3(this.client), this.organizations = new k(this.client), this.teams = new k5(this.client), this.releases = new q2(this.client), this.git = new j4(this.client), this.actions = new x(this.client);
   }
   setToken(d2) {
     return this.client.setToken(d2), this;
@@ -843,6 +844,12 @@ function groupCommitsByType(commits) {
   }
   return groups;
 }
+function filterCommitsForPackage(commits, packageName, isMonorepo) {
+  if (!isMonorepo) {
+    return commits;
+  }
+  return commits.filter((commit) => !commit.scope || commit.scope === packageName);
+}
 function hasBreakingChanges(commits) {
   return commits.some((commit) => commit.breaking);
 }
@@ -1139,12 +1146,6 @@ async function isWorkingTreeClean() {
     return false;
   }
 }
-async function addChangedFiles() {
-  console.log("\uD83D\uDCE5 Adding changed files to staging area...");
-  await git("add -A");
-  console.log(`✅ Files added to staging area
-`);
-}
 async function tagExists(tag) {
   try {
     await git(`rev-parse "${tag}"`);
@@ -1384,13 +1385,13 @@ async function updatePackageFiles(pkg, newVersion, changelogEntry) {
   await updateChangelogFile(changelogPath, changelogEntry);
   return changelogPath;
 }
-async function collectCommits(pkg, options, warnings) {
+async function collectCommits(pkg, options, warnings, isMonorepo) {
   const rawCommits = await getCommitsSinceTag(pkg.tagPrefix, pkg.path);
   if (rawCommits.length === 0 && !options.version) {
     throw new Error(`No commits found since last release for ${pkg.packageName}`);
   }
   const commits = parseCommits(rawCommits);
-  const filteredCommits = commits.filter((commit) => !commit.scope || commit.scope === pkg.name);
+  const filteredCommits = filterCommitsForPackage(commits, pkg.name, isMonorepo);
   if (filteredCommits.length === 0 && !options.version) {
     warnings.push("No conventional commits found, but will proceed with patch bump");
   }
@@ -1426,6 +1427,12 @@ async function createGitVerseRelease(options, repoInfo, commits, config, pkg, ve
 }
 async function performGitOperations(config, options, pkg, newVersion, tag, changelogPath) {
   if (config.git.commitChanges && !options.noCommit) {
+    if (config.git.beforeCommit) {
+      const hookSuccess = await runBeforeCommitHook(config.git.beforeCommit);
+      if (!hookSuccess) {
+        console.warn("⚠️  beforeCommit hook failed, proceeding with unformatted files");
+      }
+    }
     const commitMessage = config.git.commitMessage.replace("{{package}}", pkg.name).replace("{{version}}", newVersion);
     await createCommit(commitMessage, [resolve2(pkg.path, "package.json"), changelogPath]);
   }
@@ -1452,18 +1459,12 @@ async function release(packageName, options = {}) {
     const repoInfo = await getRepoInfo();
     const pkg = await resolvePackage(config, packageName);
     result.packageName = pkg.packageName;
-    if (!options.dryRun && config.git.beforeCommit) {
-      const hookSuccess = await runBeforeCommitHook(config.git.beforeCommit);
-      if (hookSuccess) {
-        await addChangedFiles();
-      }
-    }
     if (!(options.dryRun || await isWorkingTreeClean())) {
       throw new Error("Working tree is not clean. Please commit or stash your changes.");
     }
     const currentVersion = await getCurrentVersion(pkg.path);
     result.oldVersion = currentVersion;
-    const commits = await collectCommits(pkg, options, result.warnings);
+    const commits = await collectCommits(pkg, options, result.warnings, config.monorepo.enabled);
     const prereleaseTag = resolvePrereleaseTag(options, config);
     const versionBump = calculateVersionBump(currentVersion, commits, options.version, prereleaseTag, config.versioning.preMajorMode);
     result.newVersion = versionBump.newVersion;
@@ -1887,4 +1888,4 @@ Usage: gitverse-release create-only --tag <tag> [--package <name>]`);
 }
 main();
 
-//# debugId=47967437F070163A64756E2164756E21
+//# debugId=A2D09E9236DE6AFE64756E2164756E21