@claude-flow/deployment 3.0.0-alpha.1

package/dist/validator.js

@@ -0,0 +1,251 @@
+/**
+ * Pre-Release Validator
+ * Validates package before release (lint, test, build, dependencies)
+ */
+import { execSync } from 'child_process';
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+export class Validator {
+    cwd;
+    constructor(cwd = process.cwd()) {
+        this.cwd = cwd;
+    }
+    /**
+     * Run all validation checks
+     */
+    async validate(options = {}) {
+        const { lint = true, test = true, build = true, checkDependencies = true, checkGitStatus = true, lintCommand = 'npm run lint', testCommand = 'npm test', buildCommand = 'npm run build' } = options;
+        const result = {
+            valid: true,
+            checks: {},
+            errors: [],
+            warnings: []
+        };
+        // Validate package.json
+        console.log('Validating package.json...');
+        result.checks.packageJson = await this.validatePackageJson();
+        if (!result.checks.packageJson.passed) {
+            result.valid = false;
+            result.errors.push(...(result.checks.packageJson.errors || []));
+        }
+        // Check git status
+        if (checkGitStatus) {
+            console.log('Checking git status...');
+            result.checks.gitStatus = await this.checkGitStatus();
+            if (!result.checks.gitStatus.passed) {
+                result.warnings.push(...(result.checks.gitStatus.errors || []));
+            }
+        }
+        // Check dependencies
+        if (checkDependencies) {
+            console.log('Checking dependencies...');
+            result.checks.dependencies = await this.checkDependencies();
+            if (!result.checks.dependencies.passed) {
+                result.valid = false;
+                result.errors.push(...(result.checks.dependencies.errors || []));
+            }
+        }
+        // Run linter
+        if (lint) {
+            console.log('Running linter...');
+            result.checks.lint = await this.runLint(lintCommand);
+            if (!result.checks.lint.passed) {
+                result.valid = false;
+                result.errors.push(...(result.checks.lint.errors || []));
+            }
+        }
+        // Run tests
+        if (test) {
+            console.log('Running tests...');
+            result.checks.test = await this.runTests(testCommand);
+            if (!result.checks.test.passed) {
+                result.valid = false;
+                result.errors.push(...(result.checks.test.errors || []));
+            }
+        }
+        // Run build
+        if (build) {
+            console.log('Running build...');
+            result.checks.build = await this.runBuild(buildCommand);
+            if (!result.checks.build.passed) {
+                result.valid = false;
+                result.errors.push(...(result.checks.build.errors || []));
+            }
+        }
+        return result;
+    }
+    /**
+     * Validate package.json structure and required fields
+     */
+    async validatePackageJson() {
+        const errors = [];
+        try {
+            const pkgPath = join(this.cwd, 'package.json');
+            if (!existsSync(pkgPath)) {
+                errors.push('package.json not found');
+                return { passed: false, errors };
+            }
+            const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+            // Check required fields
+            if (!pkg.name) {
+                errors.push('package.json missing "name" field');
+            }
+            if (!pkg.version) {
+                errors.push('package.json missing "version" field');
+            }
+            if (!pkg.description) {
+                errors.push('package.json missing "description" field (warning)');
+            }
+            // Validate version format
+            if (pkg.version && !/^\d+\.\d+\.\d+(?:-[a-z]+\.\d+)?$/.test(pkg.version)) {
+                errors.push(`Invalid version format: ${pkg.version}`);
+            }
+            // Check for repository field
+            if (!pkg.repository) {
+                errors.push('package.json missing "repository" field (recommended)');
+            }
+            // Warn about private package
+            if (pkg.private) {
+                errors.push('Package is marked as private - cannot be published');
+            }
+            return {
+                passed: errors.length === 0,
+                errors: errors.length > 0 ? errors : undefined
+            };
+        }
+        catch (error) {
+            errors.push(`Failed to parse package.json: ${error}`);
+            return { passed: false, errors };
+        }
+    }
+    /**
+     * Check git status for uncommitted changes
+     */
+    async checkGitStatus() {
+        try {
+            const status = this.execCommand('git status --porcelain', true);
+            if (status.trim()) {
+                return {
+                    passed: false,
+                    errors: ['Uncommitted changes detected. Commit or stash changes before release.']
+                };
+            }
+            return { passed: true };
+        }
+        catch (error) {
+            return {
+                passed: false,
+                errors: [`Git status check failed: ${error}`]
+            };
+        }
+    }
+    /**
+     * Check for dependency issues
+     */
+    async checkDependencies() {
+        const errors = [];
+        try {
+            // Check for npm audit issues
+            try {
+                this.execCommand('npm audit --audit-level moderate', false);
+            }
+            catch (error) {
+                errors.push('npm audit found security vulnerabilities');
+            }
+            // Check for outdated dependencies (non-critical)
+            try {
+                const outdated = this.execCommand('npm outdated --json', true);
+                if (outdated.trim()) {
+                    const outdatedPkgs = JSON.parse(outdated);
+                    const count = Object.keys(outdatedPkgs).length;
+                    if (count > 0) {
+                        errors.push(`${count} outdated dependencies found (warning)`);
+                    }
+                }
+            }
+            catch {
+                // Outdated check is non-critical
+            }
+            return {
+                passed: errors.length === 0,
+                errors: errors.length > 0 ? errors : undefined
+            };
+        }
+        catch (error) {
+            errors.push(`Dependency check failed: ${error}`);
+            return { passed: false, errors };
+        }
+    }
+    /**
+     * Run linter
+     */
+    async runLint(command) {
+        try {
+            this.execCommand(command, false);
+            return { passed: true };
+        }
+        catch (error) {
+            return {
+                passed: false,
+                errors: [`Linting failed: ${error}`]
+            };
+        }
+    }
+    /**
+     * Run tests
+     */
+    async runTests(command) {
+        try {
+            this.execCommand(command, false);
+            return { passed: true };
+        }
+        catch (error) {
+            return {
+                passed: false,
+                errors: [`Tests failed: ${error}`]
+            };
+        }
+    }
+    /**
+     * Run build
+     */
+    async runBuild(command) {
+        try {
+            this.execCommand(command, false);
+            return { passed: true };
+        }
+        catch (error) {
+            return {
+                passed: false,
+                errors: [`Build failed: ${error}`]
+            };
+        }
+    }
+    /**
+     * Execute command
+     */
+    execCommand(cmd, returnOutput = false) {
+        try {
+            const output = execSync(cmd, {
+                cwd: this.cwd,
+                encoding: 'utf-8',
+                stdio: returnOutput ? 'pipe' : 'inherit'
+            });
+            return returnOutput ? output : '';
+        }
+        catch (error) {
+            if (returnOutput && error instanceof Error) {
+                throw error;
+            }
+            throw error;
+        }
+    }
+}
+/**
+ * Convenience function to validate package
+ */
+export async function validate(options = {}) {
+    const validator = new Validator();
+    return validator.validate(options);
+}
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

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

package/examples/basic-release.ts

@@ -0,0 +1,92 @@
+/**
+ * Basic Release Workflow Example
+ *
+ * This example demonstrates a complete release workflow:
+ * 1. Validate package
+ * 2. Prepare release (bump version, generate changelog, create tag)
+ * 3. Publish to npm
+ */
+
+import { Validator, ReleaseManager, Publisher } from '@claude-flow/deployment';
+
+async function basicRelease() {
+  console.log('Starting release workflow...\n');
+
+  // Step 1: Validate package
+  console.log('1. Validating package...');
+  const validator = new Validator();
+  const validation = await validator.validate({
+    lint: true,
+    test: true,
+    build: true,
+    checkDependencies: true,
+    checkGitStatus: true
+  });
+
+  console.log(`   Valid: ${validation.valid}`);
+  if (validation.errors.length > 0) {
+    console.log(`   Errors: ${validation.errors.join(', ')}`);
+  }
+  if (validation.warnings.length > 0) {
+    console.log(`   Warnings: ${validation.warnings.join(', ')}`);
+  }
+
+  if (!validation.valid) {
+    console.error('\n❌ Validation failed. Fix errors before releasing.');
+    process.exit(1);
+  }
+
+  // Step 2: Prepare release
+  console.log('\n2. Preparing release...');
+  const manager = new ReleaseManager();
+  const release = await manager.prepareRelease({
+    bumpType: 'patch',        // or 'minor', 'major', 'prerelease'
+    generateChangelog: true,
+    createTag: true,
+    commit: true,
+    dryRun: false             // Set to true for testing
+  });
+
+  if (!release.success) {
+    console.error(`\n❌ Release preparation failed: ${release.error}`);
+    process.exit(1);
+  }
+
+  console.log(`   Version: ${release.oldVersion} → ${release.newVersion}`);
+  console.log(`   Tag: ${release.tag}`);
+  console.log(`   Commit: ${release.commitHash?.substring(0, 7)}`);
+
+  // Step 3: Publish to npm
+  console.log('\n3. Publishing to npm...');
+  const publisher = new Publisher();
+
+  // Verify authentication
+  const authenticated = await publisher.verifyAuth();
+  if (!authenticated) {
+    console.error('\n❌ Not authenticated with npm. Run: npm login');
+    process.exit(1);
+  }
+
+  const publish = await publisher.publishToNpm({
+    tag: 'latest',
+    access: 'public',
+    dryRun: false             // Set to true for testing
+  });
+
+  if (!publish.success) {
+    console.error(`\n❌ Publish failed: ${publish.error}`);
+    process.exit(1);
+  }
+
+  console.log(`   Package: ${publish.packageName}@${publish.version}`);
+  console.log(`   Tag: ${publish.tag}`);
+  console.log(`   Tarball: ${publish.tarball}`);
+
+  console.log('\n✅ Release completed successfully!');
+}
+
+// Run the release
+basicRelease().catch(error => {
+  console.error('Release failed:', error);
+  process.exit(1);
+});

package/examples/dry-run.ts

@@ -0,0 +1,70 @@
+/**
+ * Dry Run Example
+ *
+ * Test release without making actual changes
+ */
+
+import { prepareRelease, publishToNpm, validate } from '@claude-flow/deployment';
+
+async function dryRunRelease() {
+  console.log('Dry Run Mode - Testing release without changes\n');
+
+  // Validate package
+  console.log('1. Validating package...');
+  const validation = await validate();
+
+  if (!validation.valid) {
+    console.log('   ⚠️  Validation issues found:');
+    validation.errors.forEach(err => console.log(`      - ${err}`));
+    console.log('\n   (Continuing anyway in dry-run mode)\n');
+  } else {
+    console.log('   ✅ Package validation passed\n');
+  }
+
+  // Prepare release (dry run)
+  console.log('2. Preparing release (dry run)...');
+  const release = await prepareRelease({
+    bumpType: 'minor',
+    generateChangelog: true,
+    createTag: true,
+    commit: true,
+    dryRun: true  // No actual changes
+  });
+
+  if (release.success) {
+    console.log('   Would create release:');
+    console.log(`      Version: ${release.oldVersion} → ${release.newVersion}`);
+    console.log(`      Tag: ${release.tag}`);
+    console.log('   \n   Generated changelog:');
+    if (release.changelog) {
+      release.changelog.split('\n').forEach(line => {
+        console.log(`      ${line}`);
+      });
+    }
+    console.log();
+  }
+
+  // Publish (dry run)
+  console.log('3. Publishing to npm (dry run)...');
+  const publish = await publishToNpm({
+    tag: 'latest',
+    access: 'public',
+    dryRun: true  // No actual publish
+  });
+
+  if (publish.success) {
+    console.log('   Would publish:');
+    console.log(`      Package: ${publish.packageName}@${publish.version}`);
+    console.log(`      Tag: ${publish.tag}`);
+    console.log();
+  }
+
+  console.log('✅ Dry run completed - no changes were made');
+  console.log('   To perform actual release, remove dryRun: true option');
+}
+
+// Run dry run
+dryRunRelease().catch(error => {
+  console.error('Dry run failed:', error);
+  process.exit(1);
+});

package/examples/prerelease-workflow.ts

@@ -0,0 +1,98 @@
+/**
+ * Prerelease Workflow Example
+ *
+ * Demonstrates publishing alpha/beta/rc versions
+ */
+
+import { prepareRelease, publishToNpm } from '@claude-flow/deployment';
+
+async function prereleaseWorkflow() {
+  console.log('Prerelease Workflow\n');
+
+  // Alpha release (early development)
+  console.log('1. Creating alpha release...');
+  const alpha = await prepareRelease({
+    bumpType: 'prerelease',
+    channel: 'alpha',
+    generateChangelog: true,
+    createTag: true,
+    commit: true
+  });
+
+  if (alpha.success) {
+    console.log(`   Created: ${alpha.newVersion}`);
+
+    await publishToNpm({
+      tag: 'alpha',
+      access: 'public'
+    });
+    console.log('   Published to npm with tag "alpha"\n');
+  }
+
+  // Beta release (feature complete, testing)
+  console.log('2. Creating beta release...');
+  const beta = await prepareRelease({
+    bumpType: 'prerelease',
+    channel: 'beta',
+    generateChangelog: true,
+    createTag: true,
+    commit: true
+  });
+
+  if (beta.success) {
+    console.log(`   Created: ${beta.newVersion}`);
+
+    await publishToNpm({
+      tag: 'beta',
+      access: 'public'
+    });
+    console.log('   Published to npm with tag "beta"\n');
+  }
+
+  // RC release (release candidate)
+  console.log('3. Creating release candidate...');
+  const rc = await prepareRelease({
+    bumpType: 'prerelease',
+    channel: 'rc',
+    generateChangelog: true,
+    createTag: true,
+    commit: true
+  });
+
+  if (rc.success) {
+    console.log(`   Created: ${rc.newVersion}`);
+
+    await publishToNpm({
+      tag: 'rc',
+      access: 'public'
+    });
+    console.log('   Published to npm with tag "rc"\n');
+  }
+
+  // Final release (stable)
+  console.log('4. Creating final release...');
+  const final = await prepareRelease({
+    bumpType: 'patch',
+    generateChangelog: true,
+    createTag: true,
+    commit: true
+  });
+
+  if (final.success) {
+    console.log(`   Created: ${final.newVersion}`);
+
+    await publishToNpm({
+      tag: 'latest',
+      access: 'public'
+    });
+    console.log('   Published to npm with tag "latest"\n');
+  }
+
+  console.log('✅ Prerelease workflow completed!');
+}
+
+// Run the workflow
+prereleaseWorkflow().catch(error => {
+  console.error('Workflow failed:', error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@claude-flow/deployment",
+  "version": "3.0.0-alpha.1",
+  "type": "module",
+  "description": "Deployment module - Release management, CI/CD, versioning",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "release": "semantic-release"
+  },
+  "dependencies": {
+    "@claude-flow/shared": "^3.0.0-alpha.1"
+  },
+  "devDependencies": {
+    "semantic-release": "^22.0.0",
+    "vitest": "^1.6.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "v3alpha"
+  }
+}

package/src/__tests__/release-manager.test.ts

@@ -0,0 +1,72 @@
+/**
+ * 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);
+  });
+});