@claude-flow/deployment 3.0.0-alpha.1

package/dist/__tests__/release-manager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=release-manager.test.d.ts.map

package/dist/__tests__/release-manager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-manager.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/release-manager.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/release-manager.test.js

@@ -0,0 +1,62 @@
+/**
+ * Tests for Deployment Module
+ */
+import { describe, it, expect } from 'vitest';
+import { ReleaseManager } from '../index.js';
+describe('ReleaseManager', () => {
+    describe('Constructor', () => {
+        it('should create with default cwd', () => {
+            const manager = new ReleaseManager();
+            expect(manager).toBeDefined();
+        });
+        it('should create with custom cwd', () => {
+            const manager = new ReleaseManager('/custom/path');
+            expect(manager).toBeDefined();
+        });
+    });
+});
+describe('Version Bump Logic', () => {
+    it('should parse version parts', () => {
+        const version = '1.2.3';
+        const parts = version.split('.').map(Number);
+        expect(parts[0]).toBe(1);
+        expect(parts[1]).toBe(2);
+        expect(parts[2]).toBe(3);
+    });
+    it('should bump patch version', () => {
+        const parts = '1.0.0'.split('.').map(Number);
+        const newVersion = [parts[0], parts[1], parts[2] + 1].join('.');
+        expect(newVersion).toBe('1.0.1');
+    });
+    it('should bump minor version', () => {
+        const parts = '1.0.0'.split('.').map(Number);
+        const newVersion = [parts[0], parts[1] + 1, 0].join('.');
+        expect(newVersion).toBe('1.1.0');
+    });
+    it('should bump major version', () => {
+        const parts = '1.0.0'.split('.').map(Number);
+        const newVersion = [parts[0] + 1, 0, 0].join('.');
+        expect(newVersion).toBe('2.0.0');
+    });
+});
+describe('Changelog Generation', () => {
+    it('should format date correctly', () => {
+        const date = new Date('2026-01-05');
+        const formatted = date.toISOString().split('T')[0];
+        expect(formatted).toBe('2026-01-05');
+    });
+    it('should categorize commits by type', () => {
+        const commits = [
+            { message: 'feat: add new feature' },
+            { message: 'fix: fix bug' },
+            { message: 'docs: update docs' },
+        ];
+        const feat = commits.filter(c => c.message.startsWith('feat:'));
+        const fix = commits.filter(c => c.message.startsWith('fix:'));
+        const docs = commits.filter(c => c.message.startsWith('docs:'));
+        expect(feat).toHaveLength(1);
+        expect(fix).toHaveLength(1);
+        expect(docs).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=release-manager.test.js.map

package/dist/__tests__/release-manager.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @claude-flow/deployment
+ * Release management, CI/CD, and versioning module
+ */
+export type { VersionBumpType, ReleaseChannel, ReleaseOptions, ReleaseResult, PublishOptions, PublishResult, ValidationOptions, ValidationResult, PackageInfo, GitCommit, ChangelogEntry } from './types.js';
+export { ReleaseManager } from './release-manager.js';
+export { Publisher } from './publisher.js';
+export { Validator } from './validator.js';
+export { prepareRelease } from './release-manager.js';
+export { publishToNpm, checkVersionExists, getLatestVersion } from './publisher.js';
+export { validate } from './validator.js';
+export interface ReleaseConfig {
+    version: string;
+    channel: 'alpha' | 'beta' | 'stable';
+    changelog: boolean;
+    dryRun: boolean;
+}
+export interface DeploymentTarget {
+    name: string;
+    type: 'npm' | 'docker' | 'github-release';
+    config: Record<string, unknown>;
+}
+/**
+ * Legacy prepare release function
+ * @deprecated Use prepareRelease from release-manager instead
+ */
+export declare function prepare(config: ReleaseConfig): Promise<void>;
+/**
+ * Legacy deploy function
+ * @deprecated Use publishToNpm from publisher instead
+ */
+export declare function deploy(target: DeploymentTarget): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,SAAS,EACT,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,OAAO,EACL,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,QAAQ,EACT,MAAM,gBAAgB,CAAC;AAGxB,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,gBAAgB,CAAC;IAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlE;AAED;;;GAGG;AACH,wBAAsB,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAapE"}

package/dist/index.js

@@ -0,0 +1,45 @@
+/**
+ * @claude-flow/deployment
+ * Release management, CI/CD, and versioning module
+ */
+// Export classes
+export { ReleaseManager } from './release-manager.js';
+export { Publisher } from './publisher.js';
+export { Validator } from './validator.js';
+// Export convenience functions
+export { prepareRelease } from './release-manager.js';
+export { publishToNpm, checkVersionExists, getLatestVersion } from './publisher.js';
+export { validate } from './validator.js';
+/**
+ * Legacy prepare release function
+ * @deprecated Use prepareRelease from release-manager instead
+ */
+export async function prepare(config) {
+    const { ReleaseManager } = await import('./release-manager.js');
+    const manager = new ReleaseManager();
+    await manager.prepareRelease({
+        version: config.version,
+        channel: config.channel,
+        generateChangelog: config.changelog,
+        dryRun: config.dryRun
+    });
+}
+/**
+ * Legacy deploy function
+ * @deprecated Use publishToNpm from publisher instead
+ */
+export async function deploy(target) {
+    if (target.type === 'npm') {
+        const { Publisher } = await import('./publisher.js');
+        const publisher = new Publisher();
+        await publisher.publishToNpm({
+            tag: target.config.tag || 'latest',
+            dryRun: target.config.dryRun || false
+        });
+    }
+    else {
+        console.log(`Deploying to ${target.name} (${target.type})`);
+        throw new Error(`Deployment type ${target.type} not yet implemented`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,iBAAiB;AACjB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,+BAA+B;AAC/B,OAAO,EACL,cAAc,EACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,QAAQ,EACT,MAAM,gBAAgB,CAAC;AAgBxB;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAqB;IACjD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;IAChE,MAAM,OAAO,GAAG,IAAI,cAAc,EAAE,CAAC;IAErC,MAAM,OAAO,CAAC,cAAc,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAc;QAC9B,iBAAiB,EAAE,MAAM,CAAC,SAAS;QACnC,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAwB;IACnD,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC;QACrD,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;QAElC,MAAM,SAAS,CAAC,YAAY,CAAC;YAC3B,GAAG,EAAG,MAAM,CAAC,MAAM,CAAC,GAAc,IAAI,QAAQ;YAC9C,MAAM,EAAG,MAAM,CAAC,MAAM,CAAC,MAAkB,IAAI,KAAK;SACnD,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC,IAAI,sBAAsB,CAAC,CAAC;IACxE,CAAC;AACH,CAAC"}

package/dist/publisher.d.ts

@@ -0,0 +1,58 @@
+/**
+ * NPM Publisher
+ * Handles npm package publishing with tag support
+ */
+import type { PublishOptions, PublishResult, PackageInfo } from './types.js';
+export declare class Publisher {
+    private cwd;
+    constructor(cwd?: string);
+    /**
+     * Publish package to npm
+     */
+    publishToNpm(options?: PublishOptions): Promise<PublishResult>;
+    /**
+     * Check if package version already exists on npm
+     */
+    checkVersionExists(packageName: string, version: string): Promise<boolean>;
+    /**
+     * Get latest published version
+     */
+    getLatestVersion(packageName: string, tag?: string): Promise<string | null>;
+    /**
+     * Get package info from npm registry
+     */
+    getPackageInfo(packageName: string): Promise<PackageInfo | null>;
+    /**
+     * Verify npm authentication
+     */
+    verifyAuth(): Promise<boolean>;
+    /**
+     * Get npm registry URL
+     */
+    getRegistry(): Promise<string>;
+    /**
+     * Pack package to tarball
+     */
+    pack(outputDir?: string): Promise<string>;
+    /**
+     * Execute npm command safely using execFileSync
+     */
+    private execNpmCommand;
+    /**
+     * Execute command (for build scripts only - validated)
+     */
+    private execCommand;
+}
+/**
+ * Convenience function to publish to npm
+ */
+export declare function publishToNpm(options?: PublishOptions): Promise<PublishResult>;
+/**
+ * Convenience function to check version exists
+ */
+export declare function checkVersionExists(packageName: string, version: string): Promise<boolean>;
+/**
+ * Convenience function to get latest version
+ */
+export declare function getLatestVersion(packageName: string, tag?: string): Promise<string | null>;
+//# sourceMappingURL=publisher.d.ts.map

package/dist/publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.d.ts","sourceRoot":"","sources":["../src/publisher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7E,qBAAa,SAAS;IACpB,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,GAAE,MAAsB;IAIvC;;OAEG;IACG,YAAY,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IA6FxE;;OAEG;IACG,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAShF;;OAEG;IACG,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,SAAW,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASnF;;OAEG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAStE;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IASpC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IASpC;;OAEG;IACG,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgB/C;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,OAAO,CAAC,WAAW;CAsBpB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAGxB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,EACnB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB"}

package/dist/publisher.js

@@ -0,0 +1,229 @@
+/**
+ * NPM Publisher
+ * Handles npm package publishing with tag support
+ */
+import { execSync, execFileSync } from 'child_process';
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+export class Publisher {
+    cwd;
+    constructor(cwd = process.cwd()) {
+        this.cwd = cwd;
+    }
+    /**
+     * Publish package to npm
+     */
+    async publishToNpm(options = {}) {
+        const { tag = 'latest', access, dryRun = false, registry, otp, skipBuild = false, buildCommand = 'npm run build' } = options;
+        const result = {
+            packageName: '',
+            version: '',
+            tag,
+            success: false
+        };
+        try {
+            // Read package.json
+            const pkgPath = join(this.cwd, 'package.json');
+            if (!existsSync(pkgPath)) {
+                throw new Error('package.json not found');
+            }
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            if (pkg.private) {
+                throw new Error('Cannot publish private package');
+            }
+            result.packageName = pkg.name;
+            result.version = pkg.version;
+            // Run build if not skipped
+            if (!skipBuild) {
+                console.log('Building package...');
+                this.execCommand(buildCommand);
+            }
+            // Construct npm publish command arguments (without 'npm' prefix for execNpmCommand)
+            const publishArgs = ['publish'];
+            if (tag) {
+                publishArgs.push('--tag', tag);
+            }
+            if (access) {
+                publishArgs.push('--access', access);
+            }
+            if (registry) {
+                publishArgs.push('--registry', registry);
+            }
+            if (otp) {
+                publishArgs.push('--otp', otp);
+            }
+            if (dryRun) {
+                publishArgs.push('--dry-run');
+            }
+            // Execute publish
+            console.log(`Publishing ${result.packageName}@${result.version} with tag '${tag}'...`);
+            if (dryRun) {
+                console.log('Dry run mode - no actual publish');
+                console.log('Command: npm', publishArgs.join(' '));
+            }
+            const output = this.execNpmCommand(publishArgs, true);
+            // Parse output for tarball URL
+            const tarballMatch = output.match(/https:\/\/[^\s]+\.tgz/);
+            if (tarballMatch) {
+                result.tarball = tarballMatch[0];
+            }
+            result.publishedAt = new Date();
+            result.success = true;
+            console.log(`Successfully published ${result.packageName}@${result.version}`);
+            return result;
+        }
+        catch (error) {
+            result.error = error instanceof Error ? error.message : String(error);
+            console.error('Publish failed:', result.error);
+            return result;
+        }
+    }
+    /**
+     * Check if package version already exists on npm
+     */
+    async checkVersionExists(packageName, version) {
+        try {
+            const output = this.execNpmCommand(['view', `${packageName}@${version}`, 'version'], true);
+            return output.trim() === version;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get latest published version
+     */
+    async getLatestVersion(packageName, tag = 'latest') {
+        try {
+            const output = this.execNpmCommand(['view', `${packageName}@${tag}`, 'version'], true);
+            return output.trim();
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get package info from npm registry
+     */
+    async getPackageInfo(packageName) {
+        try {
+            const output = this.execNpmCommand(['view', packageName, '--json'], true);
+            return JSON.parse(output);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Verify npm authentication
+     */
+    async verifyAuth() {
+        try {
+            const output = this.execNpmCommand(['whoami'], true);
+            return output.trim().length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get npm registry URL
+     */
+    async getRegistry() {
+        try {
+            const output = this.execNpmCommand(['config', 'get', 'registry'], true);
+            return output.trim();
+        }
+        catch {
+            return 'https://registry.npmjs.org/';
+        }
+    }
+    /**
+     * Pack package to tarball
+     */
+    async pack(outputDir) {
+        try {
+            const packArgs = ['pack'];
+            if (outputDir) {
+                packArgs.push('--pack-destination', outputDir);
+            }
+            const output = this.execNpmCommand(packArgs, true);
+            const tarballName = output.trim().split('\n').pop() || '';
+            return outputDir ? join(outputDir, tarballName) : tarballName;
+        }
+        catch (error) {
+            throw new Error(`Failed to pack: ${error}`);
+        }
+    }
+    /**
+     * Execute npm command safely using execFileSync
+     */
+    execNpmCommand(args, returnOutput = false) {
+        try {
+            // Validate args don't contain shell metacharacters
+            for (const arg of args) {
+                if (/[;&|`$()<>]/.test(arg)) {
+                    throw new Error(`Invalid argument: contains shell metacharacters`);
+                }
+            }
+            const output = execFileSync('npm', args, {
+                cwd: this.cwd,
+                encoding: 'utf-8',
+                shell: false,
+                stdio: returnOutput ? ['pipe', 'pipe', 'pipe'] : 'inherit'
+            });
+            return returnOutput ? output : '';
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+    /**
+     * Execute command (for build scripts only - validated)
+     */
+    execCommand(cmd, returnOutput = false) {
+        // Only allow npm/npx build commands for safety
+        const allowedPrefixes = ['npm run ', 'npm ', 'npx ', 'pnpm ', 'yarn '];
+        const isAllowed = allowedPrefixes.some(prefix => cmd.startsWith(prefix));
+        if (!isAllowed) {
+            throw new Error(`Disallowed command: only npm/npx/pnpm/yarn commands are permitted`);
+        }
+        // Validate no dangerous shell metacharacters
+        if (/[;&|`$()<>]/.test(cmd)) {
+            throw new Error(`Invalid command: contains shell metacharacters`);
+        }
+        try {
+            const output = execSync(cmd, {
+                cwd: this.cwd,
+                encoding: 'utf-8',
+                stdio: returnOutput ? 'pipe' : 'inherit'
+            });
+            return returnOutput ? output : '';
+        }
+        catch (error) {
+            throw error;
+        }
+    }
+}
+/**
+ * Convenience function to publish to npm
+ */
+export async function publishToNpm(options = {}) {
+    const publisher = new Publisher();
+    return publisher.publishToNpm(options);
+}
+/**
+ * Convenience function to check version exists
+ */
+export async function checkVersionExists(packageName, version) {
+    const publisher = new Publisher();
+    return publisher.checkVersionExists(packageName, version);
+}
+/**
+ * Convenience function to get latest version
+ */
+export async function getLatestVersion(packageName, tag) {
+    const publisher = new Publisher();
+    return publisher.getLatestVersion(packageName, tag);
+}
+//# sourceMappingURL=publisher.js.map

package/dist/publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.js","sourceRoot":"","sources":["../src/publisher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,MAAM,OAAO,SAAS;IACZ,GAAG,CAAS;IAEpB,YAAY,MAAc,OAAO,CAAC,GAAG,EAAE;QACrC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,UAA0B,EAAE;QAC7C,MAAM,EACJ,GAAG,GAAG,QAAQ,EACd,MAAM,EACN,MAAM,GAAG,KAAK,EACd,QAAQ,EACR,GAAG,EACH,SAAS,GAAG,KAAK,EACjB,YAAY,GAAG,eAAe,EAC/B,GAAG,OAAO,CAAC;QAEZ,MAAM,MAAM,GAAkB;YAC5B,WAAW,EAAE,EAAE;YACf,OAAO,EAAE,EAAE;YACX,GAAG;YACH,OAAO,EAAE,KAAK;SACf,CAAC;QAEF,IAAI,CAAC;YACH,oBAAoB;YACpB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAC/C,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;YAC5C,CAAC;YAED,MAAM,GAAG,GAAgB,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;YAEpE,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACpD,CAAC;YAED,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC;YAC9B,MAAM,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;YAE7B,2BAA2B;YAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;gBACf,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;gBACnC,IAAI,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;YACjC,CAAC;YAED,oFAAoF;YACpF,MAAM,WAAW,GAAa,CAAC,SAAS,CAAC,CAAC;YAE1C,IAAI,GAAG,EAAE,CAAC;gBACR,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACjC,CAAC;YAED,IAAI,MAAM,EAAE,CAAC;gBACX,WAAW,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACvC,CAAC;YAED,IAAI,QAAQ,EAAE,CAAC;gBACb,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YAC3C,CAAC;YAED,IAAI,GAAG,EAAE,CAAC;gBACR,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YACjC,CAAC;YAED,IAAI,MAAM,EAAE,CAAC;gBACX,WAAW,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAChC,CAAC;YAED,kBAAkB;YAClB,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,OAAO,cAAc,GAAG,MAAM,CAAC,CAAC;YAEvF,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;gBAChD,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACrD,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YAEtD,+BAA+B;YAC/B,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC3D,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,CAAC,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YACnC,CAAC;YAED,MAAM,CAAC,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;YAChC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;YAEtB,OAAO,CAAC,GAAG,CAAC,0BAA0B,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;YAE9E,OAAO,MAAM,CAAC;QAEhB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/C,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kBAAkB,CAAC,WAAmB,EAAE,OAAe;QAC3D,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,EAAE,GAAG,WAAW,IAAI,OAAO,EAAE,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;YAC3F,OAAO,MAAM,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,WAAmB,EAAE,GAAG,GAAG,QAAQ;QACxD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,EAAE,GAAG,WAAW,IAAI,GAAG,EAAE,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC;YACvF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,WAAmB;QACtC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;YAC1E,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,CAAC;YACrD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;YACxE,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,6BAA6B,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI,CAAC,SAAkB;QAC3B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,SAAS,EAAE,CAAC;gBACd,QAAQ,CAAC,IAAI,CAAC,oBAAoB,EAAE,SAAS,CAAC,CAAC;YACjD,CAAC;YAED,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACnD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAE1D,OAAO,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QAChE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,IAAc,EAAE,YAAY,GAAG,KAAK;QACzD,IAAI,CAAC;YACH,mDAAmD;YACnD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,IAAI,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC5B,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;gBACrE,CAAC;YACH,CAAC;YACD,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,IAAI,EAAE;gBACvC,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;aAC3D,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,GAAW,EAAE,YAAY,GAAG,KAAK;QACnD,+CAA+C;QAC/C,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACvE,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;QACvF,CAAC;QACD,6CAA6C;QAC7C,IAAI,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,EAAE;gBAC3B,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,QAAQ,EAAE,OAAO;gBACjB,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;aACzC,CAAC,CAAC;YACH,OAAO,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,UAA0B,EAAE;IAE5B,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;IAClC,OAAO,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAmB,EACnB,OAAe;IAEf,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;IAClC,OAAO,SAAS,CAAC,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,GAAY;IAEZ,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;IAClC,OAAO,SAAS,CAAC,gBAAgB,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;AACtD,CAAC"}

package/dist/release-manager.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Release Manager
+ * Handles version bumping, changelog generation, and git tagging
+ */
+import type { ReleaseOptions, ReleaseResult } from './types.js';
+export declare class ReleaseManager {
+    private cwd;
+    constructor(cwd?: string);
+    /**
+     * Prepare a release with version bumping, changelog, and git tagging
+     */
+    prepareRelease(options?: ReleaseOptions): Promise<ReleaseResult>;
+    /**
+     * Bump version based on type
+     */
+    private bumpVersion;
+    /**
+     * Get git commits since last tag
+     */
+    private getCommitsSinceLastTag;
+    /**
+     * Parse git commits
+     */
+    private parseCommits;
+    /**
+     * Generate changelog entry from commits
+     */
+    private generateChangelogEntry;
+    /**
+     * Format changelog entry as markdown
+     */
+    private formatChangelogEntry;
+    /**
+     * Update CHANGELOG.md file
+     */
+    private updateChangelogFile;
+    /**
+     * Execute command
+     */
+    private execCommand;
+}
+/**
+ * Convenience function to prepare a release
+ */
+export declare function prepareRelease(options?: ReleaseOptions): Promise<ReleaseResult>;
+//# sourceMappingURL=release-manager.d.ts.map

package/dist/release-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-manager.d.ts","sourceRoot":"","sources":["../src/release-manager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EAKd,MAAM,YAAY,CAAC;AAEpB,qBAAa,cAAc;IACzB,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,GAAE,MAAsB;IAIvC;;OAEG;IACG,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC;IAwF1E;;OAEG;IACH,OAAO,CAAC,WAAW;IAuDnB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAW9B;;OAEG;IACH,OAAO,CAAC,YAAY;IAkCpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAqC9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAyB5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqB3B;;OAEG;IACH,OAAO,CAAC,WAAW;CAepB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAGxB"}