gitverse-release 3.2.0 → 3.3.0

package/dist/types.d.ts

@@ -18,6 +18,18 @@ export interface ReleaseConfig {
      * Настройки версионирования
      */
     versioning?: VersioningConfig;
+    /**
+     * Настройки GitVerse Release
+     */
+    gitverse?: GitVerseConfig;
+    /**
+     * Настройки retry механизма
+     */
+    retry?: RetryConfig;
+    /**
+     * Настройки генерации commitlint конфига
+     */
+    commitlint?: CommitlintGeneratorConfig;
 }
 /**
  * Конфигурация monorepo
@@ -78,6 +90,10 @@ export interface ChangelogConfig {
  * Конфигурация Git операций
  */
 export interface GitConfig {
+    /**
+     * Команда для выполнения перед коммитом (например: "bun run format")
+     */
+    beforeCommit?: string;
     /**
      * Создавать ли коммит с изменениями
      */
@@ -346,3 +362,138 @@ export interface ReleaseResult {
      */
     warnings: string[];
 }
+/**
+ * Конфигурация GitVerse Release
+ */
+export interface GitVerseConfig {
+    /**
+     * Включить создание релиза через GitVerse API
+     * Требует переменную окружения GITVERSE_TOKEN
+     */
+    enabled: boolean;
+    /**
+     * Прерывать процесс релиза при ошибке создания release (после retry)
+     * Если false, ошибки логируются как warnings
+     */
+    failOnError: boolean;
+    /**
+     * Проверять существование релиза перед созданием (идемпотентность)
+     * Позволяет безопасно перезапускать pipeline
+     */
+    checkExisting: boolean;
+}
+/**
+ * Конфигурация retry механизма
+ */
+export interface RetryConfig {
+    /**
+     * Включить retry с экспоненциальным backoff
+     */
+    enabled: boolean;
+    /**
+     * Максимальное количество попыток
+     */
+    maxAttempts: number;
+    /**
+     * Начальная задержка между попытками (мс)
+     */
+    initialDelay: number;
+    /**
+     * Максимальная задержка между попытками (мс)
+     * Ограничивает рост экспоненциального backoff
+     */
+    maxDelay: number;
+    /**
+     * Список операций для retry
+     */
+    operations: RetryOperation[];
+}
+/**
+ * Типы операций для retry
+ */
+export type RetryOperation = "push" | "createRelease";
+/**
+ * Конфигурация для генерации commitlint конфига
+ */
+export interface CommitlintGeneratorConfig {
+    /**
+     * Путь для вывода commitlint конфига
+     * @default "commitlint.config.ts"
+     */
+    output: string;
+    /**
+     * Формат выходного файла
+     * @default "ts"
+     */
+    format: "ts" | "js" | "json";
+    /**
+     * Дополнительные scopes помимо package names
+     * @default ["deps", "ci", "docs"]
+     */
+    scopes: string[];
+    /**
+     * Требовать обязательный scope
+     * @default false
+     */
+    scopeRequired: boolean;
+    /**
+     * Максимальная длина header
+     * @default 100
+     */
+    headerMaxLength: number;
+    /**
+     * Добавлять комментарии в сгенерированный файл
+     * @default true
+     */
+    comments: boolean;
+}
+/**
+ * Опции для генерации commitlint конфига (CLI)
+ */
+export interface GenerateCommitlintOptions {
+    /**
+     * Путь к release конфигу
+     * @default ".gitversereleaserc.json"
+     */
+    configPath?: string;
+    /**
+     * Путь для вывода commitlint конфига
+     * @default "commitlint.config.ts"
+     */
+    output?: string;
+    /**
+     * Формат выходного файла
+     * @default "ts"
+     */
+    format?: "ts" | "js" | "json";
+    /**
+     * Дополнительные scopes помимо package names
+     * @default ["deps", "ci", "docs"]
+     */
+    scopes?: string[];
+    /**
+     * Требовать обязательный scope
+     * @default false
+     */
+    scopeRequired?: boolean;
+    /**
+     * Максимальная длина header
+     * @default 100
+     */
+    headerMaxLength?: number;
+    /**
+     * Добавлять комментарии в сгенерированный файл
+     * @default true
+     */
+    comments?: boolean;
+    /**
+     * Dry-run режим (preview без записи)
+     * @default false
+     */
+    dryRun?: boolean;
+    /**
+     * Подробный вывод
+     * @default false
+     */
+    verbose?: boolean;
+}

package/dist/utils/changelog.d.ts

@@ -2,7 +2,7 @@ import type { ChangelogConfig, ChangelogGenerateOptions, ConventionalCommit } fr
 /**
  * Генерирует CHANGELOG для версии
  */
-export declare function generateChangelog(options: ChangelogGenerateOptions, config: ChangelogConfig): string;
+export declare function generateChangelog(options: ChangelogGenerateOptions, config: ChangelogConfig, packageName?: string): string;
 /**
  * Обновляет CHANGELOG файл, добавляя новую версию в начало
  */
@@ -11,4 +11,4 @@ export declare function updateChangelogFile(changelogPath: string, newEntry: str
  * Генерирует CHANGELOG текст для GitVerse Release
  * (компактный формат без markdown заголовков, но с полной информацией)
  */
-export declare function generateReleaseNotes(commits: ConventionalCommit[], config: ChangelogConfig, repoUrl?: string): string;
+export declare function generateReleaseNotes(commits: ConventionalCommit[], config: ChangelogConfig, repoUrl?: string, packageName?: string): string;

package/dist/utils/commitlint-generator.d.ts

@@ -0,0 +1,5 @@
+import type { GenerateCommitlintOptions, ReleaseConfig } from "../types";
+/**
+ * Генерирует commitlint конфиг из release конфига
+ */
+export declare function generateCommitlint(config: Required<ReleaseConfig>, options?: GenerateCommitlintOptions): Promise<void>;

package/dist/utils/git.d.ts

@@ -1,4 +1,14 @@
 import type { GitRepoInfo } from "../types";
+/**
+ * Выполняет команду shell
+ */
+export declare function executeCommand(command: string): Promise<string>;
+/**
+ * Выполняет beforeCommit hook
+ * Возвращает true если хук выполнился успешно
+ * Возвращает false если хук упал с ошибкой
+ */
+export declare function runBeforeCommitHook(command: string): Promise<boolean>;
 /**
  * Получает информацию о Git репозитории
  *
@@ -44,8 +54,20 @@ export declare function createTag(tag: string, message: string): Promise<void>;
 export declare function pushChanges(tag?: string): Promise<void>;
 /**
  * Проверяет, что рабочая директория чистая
+ *
+ * Формат git status --porcelain: "XY PATH"
+ * X = status in staging area (index)
+ * Y = status in working tree
+ *
+ * Staged изменения (X != ' ') допустимы - они войдут в коммит релиза
+ * Unstaged изменения (Y != ' ') запрещены - нужно закоммитить или stash
  */
 export declare function isWorkingTreeClean(): Promise<boolean>;
+/**
+ * Добавляет все измененные файлы в staging area
+ * Используется после успешного выполнения beforeCommit хука
+ */
+export declare function addChangedFiles(): Promise<void>;
 /**
  * Проверяет, что тег существует
  */

package/dist/utils/retry.d.ts

@@ -0,0 +1,35 @@
+import type { RetryConfig } from "../types";
+/**
+ * Опции для retry функции
+ */
+export interface RetryOptions {
+    /**
+     * Максимальное количество попыток
+     */
+    maxAttempts: number;
+    /**
+     * Начальная задержка (мс)
+     */
+    initialDelay: number;
+    /**
+     * Максимальная задержка (мс)
+     */
+    maxDelay: number;
+    /**
+     * Название операции для логирования
+     */
+    operationName?: string;
+}
+/**
+ * Выполняет функцию с retry механизмом и экспоненциальным backoff
+ *
+ * @param fn - Асинхронная функция для выполнения
+ * @param options - Опции retry
+ * @returns Результат выполнения функции
+ * @throws Последняя ошибка после всех попыток
+ */
+export declare function retry<T>(fn: () => Promise<T>, options: RetryOptions): Promise<T>;
+/**
+ * Создаёт функцию retry с предустановленными настройками из конфига
+ */
+export declare function createRetryFunction(config: RetryConfig): <T>(fn: () => Promise<T>, operationName?: string) => Promise<T>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gitverse-release",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "Conventional Commits release automation tool for GitVerse",
   "keywords": [
     "gitverse",
@@ -14,7 +14,7 @@
   ],
   "homepage": "https://gitverse.ru/rainypixel/gitverse-sdk#readme",
   "bugs": {
-    "url": "https://gitverse.ru/rainypixel/gitverse-sdk/issues"
+    "url": "https://gitverse.ru/RainyPixel/gitverse-sdk/tasktracker"
   },
   "repository": {
     "type": "git",
@@ -40,6 +40,7 @@
   },
   "files": [
     "dist",
+    "schema.json",
     "README.md"
   ],
   "scripts": {
@@ -50,7 +51,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "gitverse-api-sdk": "2.0.1"
+    "gitverse-api-sdk": "4.0.1"
   },
   "devDependencies": {
     "@types/bun": "1.3.0",

package/schema.json

@@ -0,0 +1,289 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "description": "Configuration file for gitverse-release tool",
+  "properties": {
+    "changelog": {
+      "default": {
+        "showAuthor": true,
+        "showHash": true,
+        "types": {}
+      },
+      "description": "CHANGELOG generation settings",
+      "properties": {
+        "showAuthor": {
+          "default": true,
+          "description": "Show commit author in changelog entries",
+          "type": "boolean"
+        },
+        "showHash": {
+          "default": true,
+          "description": "Show commit hash in changelog entries",
+          "type": "boolean"
+        },
+        "types": {
+          "additionalProperties": {
+            "type": "string"
+          },
+          "default": {
+            "build": "🏗️ Build System",
+            "chore": "🔧 Chores",
+            "ci": "👷 CI/CD",
+            "docs": "📝 Documentation",
+            "feat": "✨ Features",
+            "fix": "🐛 Bug Fixes",
+            "perf": "⚡ Performance",
+            "refactor": "♻️ Refactoring",
+            "revert": "⏪ Reverts",
+            "style": "💄 Styling",
+            "test": "✅ Tests"
+          },
+          "description": "Mapping of commit types to changelog section titles",
+          "type": "object"
+        }
+      },
+      "type": "object"
+    },
+    "commitlint": {
+      "default": {
+        "comments": true,
+        "format": "ts",
+        "headerMaxLength": 100,
+        "output": "commitlint.config.ts",
+        "scopeRequired": false,
+        "scopes": ["deps", "ci", "docs"]
+      },
+      "description": "Commitlint config generation settings",
+      "properties": {
+        "comments": {
+          "default": true,
+          "description": "Include explanatory comments in generated config",
+          "type": "boolean"
+        },
+        "format": {
+          "default": "ts",
+          "description": "Output format for commitlint config",
+          "enum": ["ts", "js", "json"],
+          "type": "string"
+        },
+        "headerMaxLength": {
+          "default": 100,
+          "description": "Maximum commit header length",
+          "type": "number"
+        },
+        "output": {
+          "default": "commitlint.config.ts",
+          "description": "Output path for generated commitlint config",
+          "type": "string"
+        },
+        "scopeRequired": {
+          "default": false,
+          "description": "Whether scope is required in commit messages",
+          "type": "boolean"
+        },
+        "scopes": {
+          "default": ["deps", "ci", "docs"],
+          "description": "Additional scopes beyond monorepo package names",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "git": {
+      "default": {
+        "commitChanges": true,
+        "commitMessage": "chore(release): {{package}} v{{version}} [skip ci]",
+        "push": true,
+        "tagMessage": "Release {{package}} v{{version}}"
+      },
+      "description": "Git operations configuration",
+      "properties": {
+        "beforeCommit": {
+          "description": "Command to run before creating commit (e.g., 'bun run format', 'npm run lint:fix'). Useful for formatting changed files",
+          "examples": ["bun run format", "npm run lint:fix", "prettier --write ."],
+          "type": "string"
+        },
+        "commitChanges": {
+          "default": true,
+          "description": "Create git commit with version changes",
+          "type": "boolean"
+        },
+        "commitMessage": {
+          "default": "chore(release): {{package}} v{{version}} [skip ci]",
+          "description": "Commit message template. Supports {{package}} and {{version}} placeholders",
+          "type": "string"
+        },
+        "push": {
+          "default": true,
+          "description": "Push changes and tags to remote repository",
+          "type": "boolean"
+        },
+        "tagMessage": {
+          "default": "Release {{package}} v{{version}}",
+          "description": "Git tag message template. Supports {{package}} and {{version}} placeholders",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "gitverse": {
+      "default": {
+        "checkExisting": true,
+        "enabled": true,
+        "failOnError": true
+      },
+      "description": "GitVerse release creation settings",
+      "properties": {
+        "checkExisting": {
+          "default": true,
+          "description": "Check if release already exists before creating. Enables idempotent pipeline runs",
+          "type": "boolean"
+        },
+        "enabled": {
+          "default": true,
+          "description": "Enable GitVerse release creation via API. Requires GITVERSE_TOKEN environment variable",
+          "type": "boolean"
+        },
+        "failOnError": {
+          "default": true,
+          "description": "Fail the entire release process if GitVerse release creation fails (after retries). When false, release creation errors are logged as warnings",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "monorepo": {
+      "default": {
+        "enabled": false,
+        "packages": []
+      },
+      "description": "Monorepo configuration for managing multiple packages",
+      "properties": {
+        "enabled": {
+          "default": false,
+          "description": "Enable monorepo mode. When true, requires --package flag in CLI",
+          "type": "boolean"
+        },
+        "packages": {
+          "default": [],
+          "description": "List of packages in the monorepo",
+          "items": {
+            "properties": {
+              "changelog": {
+                "default": "CHANGELOG.md",
+                "description": "Path to CHANGELOG file relative to package directory",
+                "type": "string"
+              },
+              "name": {
+                "description": "Short package name used in CLI (e.g., 'sdk', 'release')",
+                "type": "string"
+              },
+              "packageName": {
+                "description": "Package name in package.json (e.g., 'gitverse-api-sdk')",
+                "type": "string"
+              },
+              "path": {
+                "description": "Relative path to package directory from repository root",
+                "type": "string"
+              },
+              "tagPrefix": {
+                "description": "Git tag prefix for this package (e.g., 'v', 'sdk-v', 'release-v')",
+                "type": "string"
+              }
+            },
+            "required": ["name", "path", "packageName", "tagPrefix"],
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "retry": {
+      "default": {
+        "enabled": true,
+        "initialDelay": 2000,
+        "maxAttempts": 5,
+        "maxDelay": 30000,
+        "operations": ["push", "createRelease"]
+      },
+      "description": "Retry mechanism for network operations (push, API calls)",
+      "properties": {
+        "enabled": {
+          "default": true,
+          "description": "Enable retry mechanism with exponential backoff",
+          "type": "boolean"
+        },
+        "initialDelay": {
+          "default": 2000,
+          "description": "Initial delay between retries in milliseconds",
+          "maximum": 10000,
+          "minimum": 100,
+          "type": "integer"
+        },
+        "maxAttempts": {
+          "default": 5,
+          "description": "Maximum number of retry attempts",
+          "maximum": 10,
+          "minimum": 1,
+          "type": "integer"
+        },
+        "maxDelay": {
+          "default": 30000,
+          "description": "Maximum delay between retries in milliseconds (caps exponential backoff)",
+          "maximum": 60000,
+          "minimum": 1000,
+          "type": "integer"
+        },
+        "operations": {
+          "default": ["push", "createRelease"],
+          "description": "List of operations to retry",
+          "items": {
+            "enum": ["push", "createRelease"],
+            "type": "string"
+          },
+          "type": "array",
+          "uniqueItems": true
+        }
+      },
+      "type": "object"
+    },
+    "versioning": {
+      "default": {
+        "allowPrerelease": false,
+        "preMajorMode": "auto",
+        "prereleasePrefix": "beta",
+        "tagPrefix": "v"
+      },
+      "description": "Semantic versioning configuration",
+      "properties": {
+        "allowPrerelease": {
+          "default": false,
+          "description": "Allow prerelease versions (e.g., 1.0.0-beta.0)",
+          "type": "boolean"
+        },
+        "preMajorMode": {
+          "default": "auto",
+          "description": "Pre-major version bump behavior for BREAKING CHANGES: 'auto' (< 1.0.0 → minor, >= 1.0.0 → major), 'enabled' (always minor), 'disabled' (always major), or version string (e.g., '2.0.0')",
+          "type": "string"
+        },
+        "prereleasePrefix": {
+          "default": "beta",
+          "description": "Prerelease identifier prefix (e.g., 'beta', 'alpha', 'rc')",
+          "type": "string"
+        },
+        "tagPrefix": {
+          "default": "v",
+          "description": "Git tag prefix (e.g., 'v', 'sdk-v'). Only used in single-package mode",
+          "type": "string"
+        }
+      },
+      "type": "object"
+    }
+  },
+  "title": "GitVerse Release Configuration",
+  "type": "object"
+}