@bluefly/openstandardagents 0.5.0 → 0.5.3

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

@@ -1,108 +0,0 @@
-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.js

@@ -1,322 +0,0 @@
-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.test.d.ts

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

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

@@ -1,210 +0,0 @@
-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

package/dist/version-management/index.d.ts

@@ -1,3 +0,0 @@
-export { VersionManager } from './core/version-manager';
-export type { SubstituteOptions, RestoreOptions, DetectOptions, FileResult, SubstituteResult, RestoreResult, DetectResult, ValidateResult, BumpResult, VersionSource, BumpType, } from './core/version-manager';
-//# sourceMappingURL=index.d.ts.map

package/dist/version-management/index.js

@@ -1,2 +0,0 @@
-export { VersionManager } from './core/version-manager';
-//# sourceMappingURL=index.js.map