@bluefly/openstandardagents 0.3.6 → 0.4.0

package/dist/version-management/cli/index.js

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { VersionManager } from '../core/version-manager';
+const program = new Command();
+const versionManager = new VersionManager();
+program
+    .name('ossa-version')
+    .description('OSSA Version Management CLI')
+    .version('1.0.0');
+// Substitute command
+program
+    .command('substitute <version>')
+    .alias('sub')
+    .description('Replace {{VERSION}} placeholders with real version')
+    .option('-p, --paths <patterns...>', 'File patterns to process', [
+    '**/*.md',
+    '**/*.json',
+    '**/*.yaml',
+    '**/*.yml',
+])
+    .option('-e, --exclude <patterns...>', 'File patterns to exclude', [
+    'node_modules/**',
+    '.git/**',
+    'vendor/**',
+    'dist/**',
+    'build/**',
+])
+    .option('-d, --dry-run', 'Preview changes without modifying files', false)
+    .option('--placeholder <string>', 'Custom placeholder pattern', '{{VERSION}}')
+    .option('--cwd <path>', 'Working directory', process.cwd())
+    .action(async (version, options) => {
+    const spinner = ora('Substituting version placeholders...').start();
+    try {
+        const result = await versionManager.substitute({
+            version,
+            paths: options.paths,
+            exclude: options.exclude,
+            dryRun: options.dryRun,
+            placeholder: options.placeholder,
+            cwd: options.cwd,
+        });
+        spinner.succeed(chalk.green(result.message));
+        console.log(chalk.cyan('\nSummary:'));
+        console.log(`  Version: ${chalk.bold(result.versionUsed)}`);
+        console.log(`  Files processed: ${chalk.bold(result.filesProcessed)}`);
+        console.log(`  Replacements made: ${chalk.bold(result.replacementsMade)}`);
+        if (result.files.length > 0) {
+            console.log(chalk.cyan('\nFiles modified:'));
+            result.files.forEach((file) => {
+                console.log(`  ${chalk.gray(file.path)} (${file.replacements} replacements)`);
+            });
+        }
+        if (options.dryRun) {
+            console.log(chalk.yellow('\n⚠️  Dry run mode - no files were modified'));
+        }
+        process.exit(0);
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Failed to substitute version'));
+        console.error(chalk.red(`\nError: ${error instanceof Error ? error.message : error}`));
+        process.exit(1);
+    }
+});
+// Restore command
+program
+    .command('restore [version]')
+    .description('Restore {{VERSION}} placeholders')
+    .option('-a, --all', 'Restore all versions to placeholder', false)
+    .option('-p, --paths <patterns...>', 'File patterns to process', [
+    '**/*.md',
+    '**/*.json',
+    '**/*.yaml',
+    '**/*.yml',
+])
+    .option('-e, --exclude <patterns...>', 'File patterns to exclude', [
+    'node_modules/**',
+    '.git/**',
+    'vendor/**',
+    'dist/**',
+    'build/**',
+])
+    .option('--placeholder <string>', 'Custom placeholder pattern', '{{VERSION}}')
+    .option('--cwd <path>', 'Working directory', process.cwd())
+    .action(async (version, options) => {
+    if (!version && !options.all) {
+        console.error(chalk.red('Error: Either provide a version or use --all flag'));
+        process.exit(1);
+    }
+    const spinner = ora('Restoring version placeholders...').start();
+    try {
+        const result = await versionManager.restore({
+            version,
+            restoreAll: options.all,
+            paths: options.paths,
+            exclude: options.exclude,
+            placeholder: options.placeholder,
+            cwd: options.cwd,
+        });
+        spinner.succeed(chalk.green(result.message));
+        console.log(chalk.cyan('\nSummary:'));
+        if (result.versionRestored) {
+            console.log(`  Version restored: ${chalk.bold(result.versionRestored)}`);
+        }
+        console.log(`  Files processed: ${chalk.bold(result.filesProcessed)}`);
+        console.log(`  Replacements made: ${chalk.bold(result.replacementsMade)}`);
+        if (result.files.length > 0) {
+            console.log(chalk.cyan('\nFiles modified:'));
+            result.files.forEach((file) => {
+                console.log(`  ${chalk.gray(file.path)} (${file.replacements} replacements)`);
+            });
+        }
+        process.exit(0);
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Failed to restore version'));
+        console.error(chalk.red(`\nError: ${error instanceof Error ? error.message : error}`));
+        process.exit(1);
+    }
+});
+// Detect command
+program
+    .command('detect')
+    .description('Auto-detect version from project sources')
+    .option('-d, --directory <path>', 'Directory to search', process.cwd())
+    .option('-s, --sources <sources...>', 'Specific sources to check', ['git_tag', 'package_json', 'composer_json', 'VERSION_file', 'pyproject_toml', 'cargo_toml'])
+    .action(async (options) => {
+    const spinner = ora('Detecting version...').start();
+    try {
+        const result = await versionManager.detect({
+            directory: options.directory,
+            sources: options.sources,
+        });
+        spinner.succeed(chalk.green(`Detected version: ${chalk.bold(result.version)}`));
+        console.log(chalk.cyan('\nDetails:'));
+        console.log(`  Source: ${chalk.bold(result.source)}`);
+        if (Object.keys(result.allSources).length > 1) {
+            console.log(chalk.cyan('\nAll detected versions:'));
+            Object.entries(result.allSources).forEach(([source, version]) => {
+                const indicator = source === result.source ? chalk.green('✓') : chalk.gray(' ');
+                console.log(`  ${indicator} ${chalk.gray(source)}: ${version}`);
+            });
+        }
+        process.exit(0);
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Failed to detect version'));
+        console.error(chalk.red(`\nError: ${error instanceof Error ? error.message : error}`));
+        process.exit(1);
+    }
+});
+// Validate command
+program
+    .command('validate <version>')
+    .description('Validate semantic version format')
+    .action((version) => {
+    const result = versionManager.validate(version);
+    if (result.valid) {
+        console.log(chalk.green(`✓ Valid semantic version: ${chalk.bold(version)}`));
+        if (result.parsed) {
+            console.log(chalk.cyan('\nParsed components:'));
+            console.log(`  Major: ${chalk.bold(result.parsed.major)}`);
+            console.log(`  Minor: ${chalk.bold(result.parsed.minor)}`);
+            console.log(`  Patch: ${chalk.bold(result.parsed.patch)}`);
+            if (result.parsed.prerelease) {
+                console.log(`  Prerelease: ${chalk.bold(result.parsed.prerelease)}`);
+            }
+            if (result.parsed.build) {
+                console.log(`  Build: ${chalk.bold(result.parsed.build)}`);
+            }
+        }
+        process.exit(0);
+    }
+    else {
+        console.log(chalk.red(`✗ Invalid semantic version: ${chalk.bold(version)}`));
+        if (result.errors) {
+            console.log(chalk.red('\nErrors:'));
+            result.errors.forEach((error) => {
+                console.log(`  • ${error}`);
+            });
+        }
+        process.exit(1);
+    }
+});
+// Bump command
+program
+    .command('bump <version> <type>')
+    .description('Bump version according to semver rules')
+    .option('--prerelease <identifier>', 'Prerelease identifier (e.g., alpha, beta, rc)')
+    .action((version, type, options) => {
+    try {
+        const bumpType = type;
+        if (!['major', 'minor', 'patch', 'prerelease'].includes(bumpType)) {
+            throw new Error('Bump type must be: major, minor, patch, or prerelease');
+        }
+        const result = versionManager.bump(version, bumpType, options.prerelease);
+        console.log(chalk.green(`✓ Version bumped successfully`));
+        console.log(chalk.cyan('\nDetails:'));
+        console.log(`  Old version: ${chalk.bold(result.oldVersion)}`);
+        console.log(`  New version: ${chalk.bold(chalk.green(result.newVersion))}`);
+        console.log(`  Bump type: ${chalk.bold(result.bumpType)}`);
+        process.exit(0);
+    }
+    catch (error) {
+        console.error(chalk.red(`✗ Failed to bump version`));
+        console.error(chalk.red(`\nError: ${error instanceof Error ? error.message : error}`));
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/version-management/cli/index.js.map

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

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