@eui/mcp 1.0.3

package/dist/version/dry-run-utils.js

@@ -0,0 +1,126 @@
+/**
+ * Dry Run Mode Utilities
+ *
+ * Provides functions for detecting and managing dry run mode in the release pipeline.
+ * Dry run mode allows testing the release process without actually publishing or making changes.
+ *
+ * Validates: Requirements 15.1
+ */
+/**
+ * Checks if dry run mode is enabled via environment variable.
+ *
+ * Dry run mode is enabled when the DRY_RUN environment variable is set to:
+ * - "true" (case-insensitive)
+ * - "1"
+ * - "yes" (case-insensitive)
+ *
+ * @returns true if dry run mode is enabled, false otherwise
+ */
+export function isDryRunEnabled() {
+    const dryRunValue = process.env.DRY_RUN;
+    if (!dryRunValue) {
+        return false;
+    }
+    const normalizedValue = dryRunValue.toLowerCase().trim();
+    return normalizedValue === 'true' || normalizedValue === '1' || normalizedValue === 'yes';
+}
+/**
+ * Gets the dry run mode status as a boolean.
+ *
+ * This is an alias for isDryRunEnabled() that provides a more explicit API.
+ *
+ * @returns true if dry run mode is enabled, false otherwise
+ */
+export function getDryRunMode() {
+    return isDryRunEnabled();
+}
+/**
+ * Checks if the current execution should perform actual changes.
+ *
+ * This is the inverse of isDryRunEnabled() and can be used to guard
+ * operations that should only execute in non-dry-run mode.
+ *
+ * @returns true if actual changes should be made, false if in dry run mode
+ */
+export function shouldExecuteChanges() {
+    return !isDryRunEnabled();
+}
+/**
+ * Gets the complete dry run configuration.
+ *
+ * @returns Configuration object with dry run status and raw environment value
+ */
+export function getDryRunConfig() {
+    return {
+        enabled: isDryRunEnabled(),
+        rawValue: process.env.DRY_RUN,
+    };
+}
+/**
+ * Logs a dry run action message to the console.
+ *
+ * This helper function formats and logs messages about actions that would
+ * be performed in a real release but are skipped in dry run mode.
+ *
+ * @param action - Description of the action that would be performed
+ */
+export function logDryRunAction(action) {
+    console.log(`[DRY RUN] Would execute: ${action}`);
+}
+/**
+ * Logs a dry run skip message to the console.
+ *
+ * This helper function formats and logs messages about operations that
+ * are being skipped due to dry run mode.
+ *
+ * @param operation - Description of the operation being skipped
+ */
+export function logDryRunSkip(operation) {
+    console.log(`[DRY RUN] Skipping: ${operation}`);
+}
+/**
+ * Creates a summary of actions that would be performed in a release.
+ *
+ * This function is used in dry run mode to provide a comprehensive overview
+ * of all operations that would be executed in a real release.
+ *
+ * @param actions - Array of actions that would be performed
+ * @returns Summary object with all actions and metadata
+ *
+ * Validates: Requirements 15.5
+ */
+export function createDryRunSummary(actions) {
+    return {
+        actions,
+        totalActions: actions.length,
+        timestamp: new Date().toISOString(),
+    };
+}
+/**
+ * Displays a formatted dry run summary to the console.
+ *
+ * @param summary - The dry run summary to display
+ */
+export function displayDryRunSummary(summary) {
+    console.log('\n========================================');
+    console.log('DRY RUN SUMMARY');
+    console.log('========================================\n');
+    console.log(`Total Actions: ${summary.totalActions}`);
+    console.log(`Timestamp: ${summary.timestamp}\n`);
+    if (summary.actions.length === 0) {
+        console.log('No actions would be performed.\n');
+        return;
+    }
+    console.log('Actions that would be performed:\n');
+    for (let i = 0; i < summary.actions.length; i++) {
+        const action = summary.actions[i];
+        console.log(`${i + 1}. [${action.type.toUpperCase()}] ${action.description}`);
+        if (action.details) {
+            for (const [key, value] of Object.entries(action.details)) {
+                console.log(`   - ${key}: ${JSON.stringify(value)}`);
+            }
+        }
+    }
+    console.log('\n========================================\n');
+}
+//# sourceMappingURL=dry-run-utils.js.map

package/dist/version/dry-run-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dry-run-utils.js","sourceRoot":"","sources":["../../src/version/dry-run-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;IAExC,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,eAAe,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAEzD,OAAO,eAAe,KAAK,MAAM,IAAI,eAAe,KAAK,GAAG,IAAI,eAAe,KAAK,KAAK,CAAC;AAC5F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,eAAe,EAAE,CAAC;AAC3B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO,CAAC,eAAe,EAAE,CAAC;AAC5B,CAAC;AAiBD;;;;GAIG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,OAAO,EAAE,eAAe,EAAE;QAC1B,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO;KAC9B,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,CAAC,GAAG,CAAC,4BAA4B,MAAM,EAAE,CAAC,CAAC;AACpD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,CAAC,GAAG,CAAC,uBAAuB,SAAS,EAAE,CAAC,CAAC;AAClD,CAAC;AAoBD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAuB;IACzD,OAAO;QACL,OAAO;QACP,YAAY,EAAE,OAAO,CAAC,MAAM;QAC5B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAsB;IACzD,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC/B,OAAO,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,kBAAkB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;IAEjD,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;IAElD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QAE9E,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1D,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;AAC9D,CAAC"}

package/dist/version/git-tag-utils.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Git Tag Utilities
+ *
+ * Provides functions for formatting Git tag names and annotations.
+ * Supports semantic versioning tag format (v{MAJOR}.{MINOR}.{PATCH}).
+ */
+import type { SemanticVersion } from './version-manager.js';
+/**
+ * Formats a semantic version as a Git tag name.
+ *
+ * Tag format: v{MAJOR}.{MINOR}.{PATCH}
+ * Example: v1.2.3
+ *
+ * @param version - Semantic version object
+ * @returns Formatted Git tag name with 'v' prefix
+ */
+export declare function formatTagName(version: SemanticVersion): string;
+/**
+ * Formats a version string as a Git tag name.
+ *
+ * @param versionString - Version string in format "MAJOR.MINOR.PATCH"
+ * @returns Formatted Git tag name with 'v' prefix
+ */
+export declare function formatTagNameFromString(versionString: string): string;
+/**
+ * Formats a timestamp in ISO 8601 format.
+ *
+ * @param date - Date object to format (defaults to current date/time)
+ * @returns ISO 8601 formatted timestamp (e.g., "2024-01-15T10:30:00.000Z")
+ */
+export declare function formatTimestamp(date?: Date): string;
+/**
+ * Creates a Git tag annotation message.
+ *
+ * The annotation includes the version number and timestamp in ISO 8601 format.
+ *
+ * @param version - Semantic version object
+ * @param date - Date object for the annotation (defaults to current date/time)
+ * @returns Formatted tag annotation message
+ */
+export declare function createTagAnnotation(version: SemanticVersion, date?: Date): string;
+/**
+ * Creates a Git tag annotation message from a version string.
+ *
+ * @param versionString - Version string in format "MAJOR.MINOR.PATCH" or "vMAJOR.MINOR.PATCH"
+ * @param date - Date object for the annotation (defaults to current date/time)
+ * @returns Formatted tag annotation message
+ */
+export declare function createTagAnnotationFromString(versionString: string, date?: Date): string;
+//# sourceMappingURL=git-tag-utils.d.ts.map

package/dist/version/git-tag-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-tag-utils.d.ts","sourceRoot":"","sources":["../../src/version/git-tag-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAIrE;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAE/D;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM,CAI7F;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM,CAKpG"}

package/dist/version/git-tag-utils.js

@@ -0,0 +1,66 @@
+/**
+ * Git Tag Utilities
+ *
+ * Provides functions for formatting Git tag names and annotations.
+ * Supports semantic versioning tag format (v{MAJOR}.{MINOR}.{PATCH}).
+ */
+/**
+ * Formats a semantic version as a Git tag name.
+ *
+ * Tag format: v{MAJOR}.{MINOR}.{PATCH}
+ * Example: v1.2.3
+ *
+ * @param version - Semantic version object
+ * @returns Formatted Git tag name with 'v' prefix
+ */
+export function formatTagName(version) {
+    return `v${version.major}.${version.minor}.${version.patch}`;
+}
+/**
+ * Formats a version string as a Git tag name.
+ *
+ * @param versionString - Version string in format "MAJOR.MINOR.PATCH"
+ * @returns Formatted Git tag name with 'v' prefix
+ */
+export function formatTagNameFromString(versionString) {
+    // Remove 'v' prefix if already present
+    const cleanVersion = versionString.startsWith('v') ? versionString.slice(1) : versionString;
+    return `v${cleanVersion}`;
+}
+/**
+ * Formats a timestamp in ISO 8601 format.
+ *
+ * @param date - Date object to format (defaults to current date/time)
+ * @returns ISO 8601 formatted timestamp (e.g., "2024-01-15T10:30:00.000Z")
+ */
+export function formatTimestamp(date = new Date()) {
+    return date.toISOString();
+}
+/**
+ * Creates a Git tag annotation message.
+ *
+ * The annotation includes the version number and timestamp in ISO 8601 format.
+ *
+ * @param version - Semantic version object
+ * @param date - Date object for the annotation (defaults to current date/time)
+ * @returns Formatted tag annotation message
+ */
+export function createTagAnnotation(version, date = new Date()) {
+    const versionString = `${version.major}.${version.minor}.${version.patch}`;
+    const timestamp = formatTimestamp(date);
+    return `Release version ${versionString}\nCreated at: ${timestamp}`;
+}
+/**
+ * Creates a Git tag annotation message from a version string.
+ *
+ * @param versionString - Version string in format "MAJOR.MINOR.PATCH" or "vMAJOR.MINOR.PATCH"
+ * @param date - Date object for the annotation (defaults to current date/time)
+ * @returns Formatted tag annotation message
+ */
+export function createTagAnnotationFromString(versionString, date = new Date()) {
+    // Remove 'v' prefix if present
+    const cleanVersion = versionString.startsWith('v') ? versionString.slice(1) : versionString;
+    const timestamp = formatTimestamp(date);
+    return `Release version ${cleanVersion}\nCreated at: ${timestamp}`;
+}
+//# sourceMappingURL=git-tag-utils.js.map

package/dist/version/git-tag-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-tag-utils.js","sourceRoot":"","sources":["../../src/version/git-tag-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,OAAwB;IACpD,OAAO,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;AAC/D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,aAAqB;IAC3D,uCAAuC;IACvC,MAAM,YAAY,GAAG,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;IAC5F,OAAO,IAAI,YAAY,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,OAAa,IAAI,IAAI,EAAE;IACrD,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;AAC5B,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAwB,EAAE,OAAa,IAAI,IAAI,EAAE;IACnF,MAAM,aAAa,GAAG,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;IAC3E,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,mBAAmB,aAAa,iBAAiB,SAAS,EAAE,CAAC;AACtE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAAC,aAAqB,EAAE,OAAa,IAAI,IAAI,EAAE;IAC1F,+BAA+B;IAC/B,MAAM,YAAY,GAAG,aAAa,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;IAC5F,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IACxC,OAAO,mBAAmB,YAAY,iBAAiB,SAAS,EAAE,CAAC;AACrE,CAAC"}

package/dist/version/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Version Management Module
+ *
+ * Exports utilities for semantic version management and Git tag formatting.
+ */
+export { parseVersion, isValidVersion, formatVersion, bumpVersion, bumpVersionString, type ReleaseType, type SemanticVersion, } from './version-manager.js';
+export { formatTagName, formatTagNameFromString, formatTimestamp, createTagAnnotation, createTagAnnotationFromString, } from './git-tag-utils.js';
+export { parseConventionalCommit, groupCommitsByType, isConventionalCommit, getCommitTypes, filterCommitsByType, type ConventionalCommit, type GroupedCommits, COMMIT_TYPES, } from './changelog-utils.js';
+export { extractVersion, formatReleaseTitle, getChangelogContent, createArtifactLink, createReleasePayload, createRelease, type GitLabReleasePayload, } from './release-utils.js';
+export { isDryRunEnabled, getDryRunMode, shouldExecuteChanges, getDryRunConfig, logDryRunAction, logDryRunSkip, type DryRunConfig, } from './dry-run-utils.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/version/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/version/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EACnB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,aAAa,EACb,KAAK,YAAY,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/version/index.js

@@ -0,0 +1,11 @@
+/**
+ * Version Management Module
+ *
+ * Exports utilities for semantic version management and Git tag formatting.
+ */
+export { parseVersion, isValidVersion, formatVersion, bumpVersion, bumpVersionString, } from './version-manager.js';
+export { formatTagName, formatTagNameFromString, formatTimestamp, createTagAnnotation, createTagAnnotationFromString, } from './git-tag-utils.js';
+export { parseConventionalCommit, groupCommitsByType, isConventionalCommit, getCommitTypes, filterCommitsByType, COMMIT_TYPES, } from './changelog-utils.js';
+export { extractVersion, formatReleaseTitle, getChangelogContent, createArtifactLink, createReleasePayload, createRelease, } from './release-utils.js';
+export { isDryRunEnabled, getDryRunMode, shouldExecuteChanges, getDryRunConfig, logDryRunAction, logDryRunSkip, } from './dry-run-utils.js';
+//# sourceMappingURL=index.js.map

package/dist/version/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/version/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,WAAW,EACX,iBAAiB,GAGlB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,mBAAmB,EACnB,6BAA6B,GAC9B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,mBAAmB,EAGnB,YAAY,GACb,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,GAEd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,eAAe,EACf,aAAa,GAEd,MAAM,oBAAoB,CAAC"}

package/dist/version/release-utils.d.ts

@@ -0,0 +1,94 @@
+/**
+ * GitLab Release Utilities
+ *
+ * Provides functions for creating GitLab releases with proper formatting,
+ * changelog extraction, and artifact linking.
+ */
+/**
+ * Extract version from tag name (removes 'v' prefix if present)
+ *
+ * @param tag - Git tag name (e.g., "v1.2.3" or "1.2.3")
+ * @returns Version string without 'v' prefix (e.g., "1.2.3")
+ */
+export declare function extractVersion(tag: string): string;
+/**
+ * Format release title according to GitLab release conventions.
+ *
+ * Format: "Release v{version}"
+ * Example: "Release v1.2.3"
+ *
+ * @param tag - Git tag name (e.g., "v1.2.3" or "1.2.3")
+ * @returns Formatted release title
+ */
+export declare function formatReleaseTitle(tag: string): string;
+/**
+ * Read and extract changelog content for the release.
+ *
+ * Extracts the most recent version section from CHANGELOG.md.
+ * The function looks for content between the first ## heading and the next ## heading.
+ *
+ * @param changelogPath - Path to CHANGELOG.md file (defaults to ./CHANGELOG.md)
+ * @returns Changelog content for the most recent version, or default message if not found
+ */
+export declare function getChangelogContent(changelogPath?: string): string;
+/**
+ * Create artifact link for dist/ directory.
+ *
+ * Creates a GitLab release asset link that points to the job artifacts download URL.
+ *
+ * @param projectUrl - GitLab project URL (e.g., "https://gitlab.com/user/project")
+ * @param jobId - GitLab CI job ID
+ * @returns Asset link object for GitLab Release API
+ */
+export declare function createArtifactLink(projectUrl: string, jobId: string): {
+    name: string;
+    url: string;
+    link_type: string;
+};
+/**
+ * GitLab Release API payload structure
+ */
+export interface GitLabReleasePayload {
+    tag_name: string;
+    name: string;
+    description: string;
+    assets: {
+        links: Array<{
+            name: string;
+            url: string;
+            link_type: string;
+        }>;
+    };
+}
+/**
+ * Create GitLab release payload.
+ *
+ * Constructs the payload object for the GitLab Release API.
+ *
+ * @param tagName - Git tag name (e.g., "v1.2.3")
+ * @param releaseName - Release title (e.g., "Release v1.2.3")
+ * @param description - Release description (changelog content)
+ * @param assetLinks - Array of asset links
+ * @returns GitLab Release API payload
+ */
+export declare function createReleasePayload(tagName: string, releaseName: string, description: string, assetLinks: Array<{
+    name: string;
+    url: string;
+    link_type: string;
+}>): GitLabReleasePayload;
+/**
+ * Create GitLab release using the API.
+ *
+ * Makes a POST request to the GitLab Release API to create a new release.
+ * Handles common error cases including duplicate releases, authentication failures,
+ * and not found errors.
+ *
+ * @param apiUrl - GitLab API v4 URL (e.g., "https://gitlab.com/api/v4")
+ * @param projectId - GitLab project ID
+ * @param token - GitLab authentication token (CI_JOB_TOKEN)
+ * @param payload - Release payload object
+ * @returns Promise that resolves when release is created
+ * @throws Error if release creation fails
+ */
+export declare function createRelease(apiUrl: string, projectId: string, token: string, payload: GitLabReleasePayload): Promise<void>;
+//# sourceMappingURL=release-utils.d.ts.map

package/dist/version/release-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-utils.d.ts","sourceRoot":"","sources":["../../src/version/release-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAGtD;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CA6ClE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ;IACD,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB,CAMA;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACN,KAAK,EAAE,KAAK,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,GAAG,EAAE,MAAM,CAAC;YACZ,SAAS,EAAE,MAAM,CAAC;SACnB,CAAC,CAAC;KACJ,CAAC;CACH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,GAClE,oBAAoB,CAStB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,IAAI,CAAC,CAiDf"}

package/dist/version/release-utils.js

@@ -0,0 +1,170 @@
+/**
+ * GitLab Release Utilities
+ *
+ * Provides functions for creating GitLab releases with proper formatting,
+ * changelog extraction, and artifact linking.
+ */
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+/**
+ * Extract version from tag name (removes 'v' prefix if present)
+ *
+ * @param tag - Git tag name (e.g., "v1.2.3" or "1.2.3")
+ * @returns Version string without 'v' prefix (e.g., "1.2.3")
+ */
+export function extractVersion(tag) {
+    return tag.startsWith('v') ? tag.substring(1) : tag;
+}
+/**
+ * Format release title according to GitLab release conventions.
+ *
+ * Format: "Release v{version}"
+ * Example: "Release v1.2.3"
+ *
+ * @param tag - Git tag name (e.g., "v1.2.3" or "1.2.3")
+ * @returns Formatted release title
+ */
+export function formatReleaseTitle(tag) {
+    const version = extractVersion(tag);
+    return `Release v${version}`;
+}
+/**
+ * Read and extract changelog content for the release.
+ *
+ * Extracts the most recent version section from CHANGELOG.md.
+ * The function looks for content between the first ## heading and the next ## heading.
+ *
+ * @param changelogPath - Path to CHANGELOG.md file (defaults to ./CHANGELOG.md)
+ * @returns Changelog content for the most recent version, or default message if not found
+ */
+export function getChangelogContent(changelogPath) {
+    const path = changelogPath || resolve(process.cwd(), 'CHANGELOG.md');
+    try {
+        const content = readFileSync(path, 'utf-8');
+        // Extract the first version section (most recent)
+        // Look for content between the first ## heading and the next ## heading
+        const lines = content.split('\n');
+        const releaseLines = [];
+        let inReleaseSection = false;
+        let foundFirstHeading = false;
+        for (const line of lines) {
+            // Skip the main title (# Changelog)
+            if (line.startsWith('# ')) {
+                continue;
+            }
+            // Start capturing when we hit the first ## heading
+            if (line.startsWith('## ')) {
+                if (!foundFirstHeading) {
+                    foundFirstHeading = true;
+                    inReleaseSection = true;
+                    releaseLines.push(line);
+                    continue;
+                }
+                else {
+                    // Stop when we hit the second ## heading
+                    break;
+                }
+            }
+            if (inReleaseSection) {
+                releaseLines.push(line);
+            }
+        }
+        if (releaseLines.length === 0) {
+            return 'Release notes not available.';
+        }
+        return releaseLines.join('\n').trim();
+    }
+    catch (error) {
+        return 'Release notes not available.';
+    }
+}
+/**
+ * Create artifact link for dist/ directory.
+ *
+ * Creates a GitLab release asset link that points to the job artifacts download URL.
+ *
+ * @param projectUrl - GitLab project URL (e.g., "https://gitlab.com/user/project")
+ * @param jobId - GitLab CI job ID
+ * @returns Asset link object for GitLab Release API
+ */
+export function createArtifactLink(projectUrl, jobId) {
+    return {
+        name: 'dist',
+        url: `${projectUrl}/-/jobs/${jobId}/artifacts/download`,
+        link_type: 'package',
+    };
+}
+/**
+ * Create GitLab release payload.
+ *
+ * Constructs the payload object for the GitLab Release API.
+ *
+ * @param tagName - Git tag name (e.g., "v1.2.3")
+ * @param releaseName - Release title (e.g., "Release v1.2.3")
+ * @param description - Release description (changelog content)
+ * @param assetLinks - Array of asset links
+ * @returns GitLab Release API payload
+ */
+export function createReleasePayload(tagName, releaseName, description, assetLinks) {
+    return {
+        tag_name: tagName,
+        name: releaseName,
+        description: description,
+        assets: {
+            links: assetLinks,
+        },
+    };
+}
+/**
+ * Create GitLab release using the API.
+ *
+ * Makes a POST request to the GitLab Release API to create a new release.
+ * Handles common error cases including duplicate releases, authentication failures,
+ * and not found errors.
+ *
+ * @param apiUrl - GitLab API v4 URL (e.g., "https://gitlab.com/api/v4")
+ * @param projectId - GitLab project ID
+ * @param token - GitLab authentication token (CI_JOB_TOKEN)
+ * @param payload - Release payload object
+ * @returns Promise that resolves when release is created
+ * @throws Error if release creation fails
+ */
+export async function createRelease(apiUrl, projectId, token, payload) {
+    const releaseUrl = `${apiUrl}/projects/${encodeURIComponent(projectId)}/releases`;
+    const response = await fetch(releaseUrl, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            'JOB-TOKEN': token,
+        },
+        body: JSON.stringify(payload),
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        // Check for duplicate release (409 Conflict) - this is idempotent
+        if (response.status === 409) {
+            // Don't throw error for duplicate - just return silently
+            return;
+        }
+        // Check for authentication errors
+        if (response.status === 401 || response.status === 403) {
+            throw new Error(`Authentication failed: ${response.status} ${response.statusText}\n` +
+                'Possible causes:\n' +
+                '  - Invalid or expired CI_JOB_TOKEN\n' +
+                '  - Insufficient permissions to create releases\n' +
+                '  - Token does not have api scope');
+        }
+        // Check for not found (invalid project or tag)
+        if (response.status === 404) {
+            throw new Error(`Not found: ${response.status} ${response.statusText}\n` +
+                'Possible causes:\n' +
+                `  - Project ID ${projectId} does not exist\n` +
+                `  - Tag ${payload.tag_name} does not exist\n` +
+                '  - Insufficient permissions to access the project');
+        }
+        // Generic error
+        throw new Error(`Failed to create release: ${response.status} ${response.statusText}\n` +
+            `Response: ${errorText}`);
+    }
+}
+//# sourceMappingURL=release-utils.js.map

package/dist/version/release-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-utils.js","sourceRoot":"","sources":["../../src/version/release-utils.ts"],"names":[],"mappings":"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"}

package/dist/version/rollback-utils.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Rollback Utilities
+ *
+ * Provides functions for rolling back to previous versions.
+ * Validates: Requirements 11.1, 11.2, 11.3, 11.5
+ */
+/**
+ * Result of a rollback validation
+ */
+export interface RollbackValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Validates a rollback version string.
+ *
+ * Checks:
+ * - Version format is valid
+ * - Version is not the current version
+ *
+ * @param rollbackVersion - The version to rollback to
+ * @param currentVersion - The current version
+ * @returns Validation result with error message if invalid
+ *
+ * Validates: Requirements 11.1, 11.2
+ */
+export declare function validateRollbackVersion(rollbackVersion: string, currentVersion: string): RollbackValidationResult;
+/**
+ * Formats a rollback changelog entry.
+ *
+ * @param version - The version being rolled back to
+ * @param reason - Optional reason for the rollback
+ * @returns Formatted changelog entry
+ *
+ * Validates: Requirements 11.5
+ */
+export declare function formatRollbackChangelogEntry(version: string, reason?: string): string;
+/**
+ * Generates a Git tag name for a rollback.
+ *
+ * @param version - The version being rolled back to
+ * @returns Git tag name (e.g., "v1.2.3")
+ *
+ * Validates: Requirements 11.3
+ */
+export declare function generateRollbackTag(version: string): string;
+//# sourceMappingURL=rollback-utils.d.ts.map

package/dist/version/rollback-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollback-utils.d.ts","sourceRoot":"","sources":["../../src/version/rollback-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,GACrB,wBAAwB,CAqB1B;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAeR;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAG3D"}