@bluefly/openstandardagents 0.3.5 → 0.4.0

package/dist/version-management/core/version-manager.d.ts

@@ -0,0 +1,108 @@
+export interface SubstituteOptions {
+    version: string;
+    paths?: string[];
+    exclude?: string[];
+    dryRun?: boolean;
+    placeholder?: string;
+    cwd?: string;
+}
+export interface RestoreOptions {
+    version?: string;
+    restoreAll?: boolean;
+    paths?: string[];
+    exclude?: string[];
+    placeholder?: string;
+    cwd?: string;
+}
+export interface DetectOptions {
+    directory?: string;
+    sources?: VersionSource[];
+}
+export interface FileResult {
+    path: string;
+    replacements: number;
+    preview?: {
+        line: number;
+        before: string;
+        after: string;
+    }[];
+}
+export interface SubstituteResult {
+    success: boolean;
+    versionUsed: string;
+    filesProcessed: number;
+    replacementsMade: number;
+    dryRun?: boolean;
+    message: string;
+    files: FileResult[];
+}
+export interface RestoreResult {
+    success: boolean;
+    versionRestored?: string;
+    filesProcessed: number;
+    replacementsMade: number;
+    message: string;
+    files: FileResult[];
+}
+export interface DetectResult {
+    success: boolean;
+    version: string;
+    source: VersionSource;
+    allSources: Record<string, string>;
+}
+export interface ValidateResult {
+    success: boolean;
+    valid: boolean;
+    version: string;
+    parsed?: {
+        major: number;
+        minor: number;
+        patch: number;
+        prerelease?: string;
+        build?: string;
+    };
+    errors?: string[];
+}
+export interface BumpResult {
+    success: boolean;
+    oldVersion: string;
+    newVersion: string;
+    bumpType: BumpType;
+}
+export type VersionSource = 'git_tag' | 'package_json' | 'composer_json' | 'VERSION_file' | 'pyproject_toml' | 'cargo_toml';
+export type BumpType = 'major' | 'minor' | 'patch' | 'prerelease';
+export declare class VersionManager {
+    /**
+     * Substitute version placeholders with real version
+     */
+    substitute(options: SubstituteOptions): Promise<SubstituteResult>;
+    /**
+     * Restore version placeholders (reverse of substitute)
+     */
+    restore(options: RestoreOptions): Promise<RestoreResult>;
+    /**
+     * Detect version from various sources
+     */
+    detect(options?: DetectOptions): Promise<DetectResult>;
+    /**
+     * Validate semantic version format
+     */
+    validate(version: string): ValidateResult;
+    /**
+     * Bump version according to semver rules
+     */
+    bump(version: string, bumpType: BumpType, prereleaseIdentifier?: string): BumpResult;
+    /**
+     * Detect version from specific source
+     */
+    private detectFromSource;
+    /**
+     * Normalize version (ensure consistent format)
+     */
+    private normalizeVersion;
+    /**
+     * Escape special regex characters
+     */
+    private escapeRegex;
+}
+//# sourceMappingURL=version-manager.d.ts.map

package/dist/version-management/core/version-manager.d.ts.map

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

package/dist/version-management/core/version-manager.js

@@ -0,0 +1,319 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as semver from 'semver';
+import fg from 'fast-glob';
+import { execSync } from 'child_process';
+const DEFAULT_PATHS = ['**/*.md', '**/*.json', '**/*.yaml', '**/*.yml'];
+const DEFAULT_EXCLUDE = [
+    'node_modules/**',
+    '.git/**',
+    'vendor/**',
+    'dist/**',
+    'build/**',
+    '**/package-lock.json',
+    '**/yarn.lock',
+    '**/pnpm-lock.yaml',
+];
+const DEFAULT_PLACEHOLDER = '{{VERSION}}';
+export class VersionManager {
+    /**
+     * Substitute version placeholders with real version
+     */
+    async substitute(options) {
+        const { version, paths = DEFAULT_PATHS, exclude = DEFAULT_EXCLUDE, dryRun = false, placeholder = DEFAULT_PLACEHOLDER, cwd = process.cwd(), } = options;
+        // Validate version
+        const validation = this.validate(version);
+        if (!validation.valid) {
+            throw new Error(`Invalid version format: ${validation.errors?.join(', ')}`);
+        }
+        // Normalize version (add 'v' prefix if not present and original had it)
+        const normalizedVersion = this.normalizeVersion(version);
+        // Find files
+        const files = await fg(paths, {
+            cwd,
+            ignore: exclude,
+            absolute: false,
+        });
+        const results = [];
+        let totalReplacements = 0;
+        for (const file of files) {
+            const filePath = path.join(cwd, file);
+            const content = await fs.readFile(filePath, 'utf-8');
+            // Count and replace placeholders
+            const regex = new RegExp(this.escapeRegex(placeholder), 'g');
+            const matches = content.match(regex);
+            const replacements = matches ? matches.length : 0;
+            if (replacements > 0) {
+                const newContent = content.replace(regex, normalizedVersion);
+                if (!dryRun) {
+                    await fs.writeFile(filePath, newContent, 'utf-8');
+                }
+                results.push({
+                    path: file,
+                    replacements,
+                });
+                totalReplacements += replacements;
+            }
+        }
+        return {
+            success: true,
+            versionUsed: normalizedVersion,
+            filesProcessed: files.length,
+            replacementsMade: totalReplacements,
+            dryRun,
+            message: dryRun
+                ? `Dry run: Would replace ${totalReplacements} occurrences in ${results.length} files`
+                : `Successfully replaced ${totalReplacements} occurrences in ${results.length} files`,
+            files: results,
+        };
+    }
+    /**
+     * Restore version placeholders (reverse of substitute)
+     */
+    async restore(options) {
+        const { version, restoreAll = false, paths = DEFAULT_PATHS, exclude = DEFAULT_EXCLUDE, placeholder = DEFAULT_PLACEHOLDER, cwd = process.cwd(), } = options;
+        if (!version && !restoreAll) {
+            throw new Error('Either version or restoreAll must be specified');
+        }
+        // Find files
+        const files = await fg(paths, {
+            cwd,
+            ignore: exclude,
+            absolute: false,
+        });
+        const results = [];
+        let totalReplacements = 0;
+        for (const file of files) {
+            const filePath = path.join(cwd, file);
+            const content = await fs.readFile(filePath, 'utf-8');
+            let newContent = content;
+            let replacements = 0;
+            if (restoreAll) {
+                // Replace all semver patterns with placeholder
+                const semverRegex = /v?\d+\.\d+\.\d+(-[a-zA-Z0-9.]+)?(\+[a-zA-Z0-9.]+)?/g;
+                const matches = content.match(semverRegex);
+                replacements = matches ? matches.length : 0;
+                newContent = content.replace(semverRegex, placeholder);
+            }
+            else if (version) {
+                // Replace specific version with placeholder
+                const normalizedVersion = this.normalizeVersion(version);
+                const regex = new RegExp(this.escapeRegex(normalizedVersion), 'g');
+                const matches = content.match(regex);
+                replacements = matches ? matches.length : 0;
+                newContent = content.replace(regex, placeholder);
+            }
+            if (replacements > 0) {
+                await fs.writeFile(filePath, newContent, 'utf-8');
+                results.push({
+                    path: file,
+                    replacements,
+                });
+                totalReplacements += replacements;
+            }
+        }
+        return {
+            success: true,
+            versionRestored: version,
+            filesProcessed: files.length,
+            replacementsMade: totalReplacements,
+            message: `Successfully restored ${totalReplacements} occurrences to ${placeholder} in ${results.length} files`,
+            files: results,
+        };
+    }
+    /**
+     * Detect version from various sources
+     */
+    async detect(options = {}) {
+        const { directory = process.cwd(), sources } = options;
+        const allSources = {};
+        const checkSources = sources || [
+            'git_tag',
+            'package_json',
+            'composer_json',
+            'VERSION_file',
+            'pyproject_toml',
+            'cargo_toml',
+        ];
+        // Check each source
+        for (const source of checkSources) {
+            try {
+                const version = await this.detectFromSource(source, directory);
+                if (version) {
+                    allSources[source] = version;
+                }
+            }
+            catch (error) {
+                // Source not available, continue
+            }
+        }
+        // Priority order
+        const priorityOrder = [
+            'git_tag',
+            'package_json',
+            'composer_json',
+            'VERSION_file',
+            'pyproject_toml',
+            'cargo_toml',
+        ];
+        for (const source of priorityOrder) {
+            if (allSources[source]) {
+                return {
+                    success: true,
+                    version: allSources[source],
+                    source,
+                    allSources,
+                };
+            }
+        }
+        throw new Error('Could not detect version from any source');
+    }
+    /**
+     * Validate semantic version format
+     */
+    validate(version) {
+        const cleaned = semver.clean(version);
+        if (!cleaned) {
+            return {
+                success: true,
+                valid: false,
+                version,
+                errors: ['Invalid semantic version format'],
+            };
+        }
+        const parsed = semver.parse(cleaned);
+        if (!parsed) {
+            return {
+                success: true,
+                valid: false,
+                version,
+                errors: ['Could not parse version'],
+            };
+        }
+        return {
+            success: true,
+            valid: true,
+            version,
+            parsed: {
+                major: parsed.major,
+                minor: parsed.minor,
+                patch: parsed.patch,
+                prerelease: parsed.prerelease.length > 0 ? parsed.prerelease.join('.') : undefined,
+                build: parsed.build.length > 0 ? parsed.build.join('.') : undefined,
+            },
+        };
+    }
+    /**
+     * Bump version according to semver rules
+     */
+    bump(version, bumpType, prereleaseIdentifier) {
+        const cleaned = semver.clean(version);
+        if (!cleaned) {
+            throw new Error('Invalid version format');
+        }
+        let newVersion;
+        if (bumpType === 'prerelease' && prereleaseIdentifier) {
+            newVersion = semver.inc(cleaned, 'prerelease', prereleaseIdentifier) || '';
+        }
+        else {
+            newVersion = semver.inc(cleaned, bumpType) || '';
+        }
+        if (!newVersion) {
+            throw new Error(`Failed to bump version: ${version} (${bumpType})`);
+        }
+        return {
+            success: true,
+            oldVersion: cleaned,
+            newVersion,
+            bumpType,
+        };
+    }
+    /**
+     * Detect version from specific source
+     */
+    async detectFromSource(source, directory) {
+        switch (source) {
+            case 'git_tag':
+                try {
+                    const tag = execSync('git describe --tags --abbrev=0', {
+                        cwd: directory,
+                        encoding: 'utf-8',
+                    }).trim();
+                    return tag;
+                }
+                catch {
+                    return null;
+                }
+            case 'package_json': {
+                const pkgPath = path.join(directory, 'package.json');
+                try {
+                    const content = await fs.readFile(pkgPath, 'utf-8');
+                    const pkg = JSON.parse(content);
+                    return pkg.version || null;
+                }
+                catch {
+                    return null;
+                }
+            }
+            case 'composer_json': {
+                const composerPath = path.join(directory, 'composer.json');
+                try {
+                    const content = await fs.readFile(composerPath, 'utf-8');
+                    const composer = JSON.parse(content);
+                    return composer.version || null;
+                }
+                catch {
+                    return null;
+                }
+            }
+            case 'VERSION_file': {
+                const versionPath = path.join(directory, 'VERSION');
+                try {
+                    const content = await fs.readFile(versionPath, 'utf-8');
+                    return content.trim();
+                }
+                catch {
+                    return null;
+                }
+            }
+            case 'pyproject_toml': {
+                const pyprojectPath = path.join(directory, 'pyproject.toml');
+                try {
+                    const content = await fs.readFile(pyprojectPath, 'utf-8');
+                    const match = content.match(/version\s*=\s*"([^"]+)"/);
+                    return match ? match[1] : null;
+                }
+                catch {
+                    return null;
+                }
+            }
+            case 'cargo_toml': {
+                const cargoPath = path.join(directory, 'Cargo.toml');
+                try {
+                    const content = await fs.readFile(cargoPath, 'utf-8');
+                    const match = content.match(/version\s*=\s*"([^"]+)"/);
+                    return match ? match[1] : null;
+                }
+                catch {
+                    return null;
+                }
+            }
+            default:
+                return null;
+        }
+    }
+    /**
+     * Normalize version (ensure consistent format)
+     */
+    normalizeVersion(version) {
+        // If version starts with 'v', keep it. Otherwise add it.
+        return version.startsWith('v') ? version : `v${version}`;
+    }
+    /**
+     * Escape special regex characters
+     */
+    escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+}
+//# sourceMappingURL=version-manager.js.map

package/dist/version-management/core/version-manager.js.map

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

package/dist/version-management/core/version-manager.test.d.ts

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

package/dist/version-management/core/version-manager.test.d.ts.map

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

package/dist/version-management/core/version-manager.test.js

@@ -0,0 +1,210 @@
+import { VersionManager } from './version-manager';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import * as os from 'os';
+describe('VersionManager', () => {
+    let versionManager;
+    let tempDir;
+    beforeEach(async () => {
+        versionManager = new VersionManager();
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'ossa-version-test-'));
+    });
+    afterEach(async () => {
+        await fs.rm(tempDir, { recursive: true, force: true });
+    });
+    describe('validate', () => {
+        it('should validate correct semantic versions', () => {
+            const testCases = [
+                '0.4.2',
+                'v0.4.2',
+                '1.2.3',
+                '1.2.3-alpha.1',
+                '2.0.0-rc.1+build.123',
+            ];
+            testCases.forEach((version) => {
+                const result = versionManager.validate(version);
+                expect(result.valid).toBe(true);
+                expect(result.success).toBe(true);
+                expect(result.parsed).toBeDefined();
+            });
+        });
+        it('should reject invalid semantic versions', () => {
+            const testCases = ['0.4', '1.2.3.4', 'latest', 'v1', 'invalid'];
+            testCases.forEach((version) => {
+                const result = versionManager.validate(version);
+                expect(result.valid).toBe(false);
+                expect(result.errors).toBeDefined();
+            });
+        });
+        it('should parse version components correctly', () => {
+            const result = versionManager.validate('1.2.3-alpha.1');
+            expect(result.valid).toBe(true);
+            expect(result.parsed).toEqual({
+                major: 1,
+                minor: 2,
+                patch: 3,
+                prerelease: 'alpha.1',
+                build: undefined,
+            });
+        });
+    });
+    describe('bump', () => {
+        it('should bump major version', () => {
+            const result = versionManager.bump('0.4.2', 'major');
+            expect(result.success).toBe(true);
+            expect(result.oldVersion).toBe('0.4.2');
+            expect(result.newVersion).toBe('1.0.0');
+            expect(result.bumpType).toBe('major');
+        });
+        it('should bump minor version', () => {
+            const result = versionManager.bump('0.4.2', 'minor');
+            expect(result.success).toBe(true);
+            expect(result.newVersion).toBe('0.5.0');
+        });
+        it('should bump patch version', () => {
+            const result = versionManager.bump('0.4.2', 'patch');
+            expect(result.success).toBe(true);
+            expect(result.newVersion).toBe('0.4.3');
+        });
+        it('should bump to prerelease', () => {
+            const result = versionManager.bump('0.4.2', 'prerelease', 'alpha');
+            expect(result.success).toBe(true);
+            expect(result.newVersion).toBe('0.4.3-alpha.0');
+        });
+        it('should handle versions with v prefix', () => {
+            const result = versionManager.bump('v0.4.2', 'patch');
+            expect(result.success).toBe(true);
+            expect(result.oldVersion).toBe('0.4.2');
+            expect(result.newVersion).toBe('0.4.3');
+        });
+    });
+    describe('substitute', () => {
+        it('should replace placeholders in files', async () => {
+            // Create test files
+            const testFile1 = path.join(tempDir, 'test1.md');
+            const testFile2 = path.join(tempDir, 'test2.json');
+            await fs.writeFile(testFile1, '# Version {{VERSION}}\n\nThis is version {{VERSION}} of the project.');
+            await fs.writeFile(testFile2, JSON.stringify({
+                apiVersion: 'ossa/v{{VERSION}}',
+                version: '{{VERSION}}',
+            }));
+            const result = await versionManager.substitute({
+                version: '0.4.2',
+                paths: ['**/*.md', '**/*.json'],
+                cwd: tempDir,
+            });
+            expect(result.success).toBe(true);
+            expect(result.versionUsed).toBe('v0.4.2');
+            expect(result.filesProcessed).toBe(2);
+            expect(result.replacementsMade).toBe(4);
+            // Verify file contents
+            const content1 = await fs.readFile(testFile1, 'utf-8');
+            expect(content1).toContain('# Version v0.4.2');
+            expect(content1).toContain('This is version v0.4.2 of the project.');
+            const content2 = await fs.readFile(testFile2, 'utf-8');
+            const json = JSON.parse(content2);
+            expect(json.apiVersion).toBe('ossa/vv0.4.2');
+            expect(json.version).toBe('v0.4.2');
+        });
+        it('should support dry run mode', async () => {
+            const testFile = path.join(tempDir, 'test.md');
+            await fs.writeFile(testFile, '# Version {{VERSION}}');
+            const result = await versionManager.substitute({
+                version: '0.4.2',
+                paths: ['**/*.md'],
+                cwd: tempDir,
+                dryRun: true,
+            });
+            expect(result.success).toBe(true);
+            expect(result.dryRun).toBe(true);
+            expect(result.replacementsMade).toBe(1);
+            // Verify file was NOT modified
+            const content = await fs.readFile(testFile, 'utf-8');
+            expect(content).toBe('# Version {{VERSION}}');
+        });
+        it('should handle custom placeholders', async () => {
+            const testFile = path.join(tempDir, 'test.md');
+            await fs.writeFile(testFile, '# Version $VERSION');
+            const result = await versionManager.substitute({
+                version: '0.4.2',
+                paths: ['**/*.md'],
+                cwd: tempDir,
+                placeholder: '$VERSION',
+            });
+            expect(result.success).toBe(true);
+            expect(result.replacementsMade).toBe(1);
+            const content = await fs.readFile(testFile, 'utf-8');
+            expect(content).toBe('# Version v0.4.2');
+        });
+        it('should respect exclude patterns', async () => {
+            // Create files
+            const includedFile = path.join(tempDir, 'included.md');
+            const excludedDir = path.join(tempDir, 'node_modules');
+            await fs.mkdir(excludedDir);
+            const excludedFile = path.join(excludedDir, 'excluded.md');
+            await fs.writeFile(includedFile, '{{VERSION}}');
+            await fs.writeFile(excludedFile, '{{VERSION}}');
+            const result = await versionManager.substitute({
+                version: '0.4.2',
+                paths: ['**/*.md'],
+                exclude: ['node_modules/**'],
+                cwd: tempDir,
+            });
+            expect(result.filesProcessed).toBe(1);
+            expect(result.replacementsMade).toBe(1);
+            // Verify excluded file was NOT modified
+            const excludedContent = await fs.readFile(excludedFile, 'utf-8');
+            expect(excludedContent).toBe('{{VERSION}}');
+        });
+    });
+    describe('restore', () => {
+        it('should restore specific version to placeholder', async () => {
+            const testFile = path.join(tempDir, 'test.md');
+            await fs.writeFile(testFile, '# Version v0.4.2\n\nThis is v0.4.2.');
+            const result = await versionManager.restore({
+                version: '0.4.2',
+                paths: ['**/*.md'],
+                cwd: tempDir,
+            });
+            expect(result.success).toBe(true);
+            expect(result.replacementsMade).toBe(2);
+            const content = await fs.readFile(testFile, 'utf-8');
+            expect(content).toBe('# Version {{VERSION}}\n\nThis is {{VERSION}}.');
+        });
+        it('should restore all versions to placeholder', async () => {
+            const testFile = path.join(tempDir, 'test.md');
+            await fs.writeFile(testFile, 'v0.4.2, v0.4.1, v1.0.0, and even 2.3.4');
+            const result = await versionManager.restore({
+                restoreAll: true,
+                paths: ['**/*.md'],
+                cwd: tempDir,
+            });
+            expect(result.success).toBe(true);
+            expect(result.replacementsMade).toBe(4);
+            const content = await fs.readFile(testFile, 'utf-8');
+            expect(content).toBe('{{VERSION}}, {{VERSION}}, {{VERSION}}, and even {{VERSION}}');
+        });
+    });
+    describe('detect', () => {
+        it('should detect version from package.json', async () => {
+            const packageJson = path.join(tempDir, 'package.json');
+            await fs.writeFile(packageJson, JSON.stringify({ name: 'test', version: '0.4.2' }));
+            const result = await versionManager.detect({ directory: tempDir });
+            expect(result.success).toBe(true);
+            expect(result.version).toBe('0.4.2');
+            expect(result.source).toBe('package_json');
+        });
+        it('should detect version from VERSION file', async () => {
+            const versionFile = path.join(tempDir, 'VERSION');
+            await fs.writeFile(versionFile, 'v0.4.2\n');
+            const result = await versionManager.detect({ directory: tempDir });
+            expect(result.success).toBe(true);
+            expect(result.version).toBe('v0.4.2');
+            expect(result.source).toBe('VERSION_file');
+        });
+        it('should throw error when no version found', async () => {
+            await expect(versionManager.detect({ directory: tempDir })).rejects.toThrow('Could not detect version from any source');
+        });
+    });
+});
+//# sourceMappingURL=version-manager.test.js.map