@bluefly/openstandardagents 0.3.6 → 0.4.1

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"version-manager.test.js","sourceRoot":"","sources":["../../../src/version-management/core/version-manager.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAGzB,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,IAAI,cAA8B,CAAC;IACnC,IAAI,OAAe,CAAC;IAEpB,UAAU,CAAC,KAAK,IAAI,EAAE;QACpB,cAAc,GAAG,IAAI,cAAc,EAAE,CAAC;QACtC,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,KAAK,IAAI,EAAE;QACnB,MAAM,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;QACxB,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,SAAS,GAAG;gBAChB,OAAO;gBACP,QAAQ;gBACR,OAAO;gBACP,eAAe;gBACf,sBAAsB;aACvB,CAAC;YAEF,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC5B,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAChD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAChC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;YACtC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;YACjD,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;YAEhE,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC5B,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBAChD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACjC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;YACtC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;YACnD,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;YACxD,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;gBAC5B,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,CAAC;gBACR,KAAK,EAAE,CAAC;gBACR,UAAU,EAAE,SAAS;gBACrB,KAAK,EAAE,SAAS;aACjB,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;QACpB,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;YACnC,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;YACnC,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;YACnC,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;YACnC,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,EAAE,OAAO,CAAC,CAAC;YACnE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;YAC9C,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACtD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACpD,oBAAoB;YACpB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YACjD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;YAEnD,MAAM,EAAE,CAAC,SAAS,CAChB,SAAS,EACT,sEAAsE,CACvE,CAAC;YACF,MAAM,EAAE,CAAC,SAAS,CAChB,SAAS,EACT,IAAI,CAAC,SAAS,CAAC;gBACb,UAAU,EAAE,mBAAmB;gBAC/B,OAAO,EAAE,aAAa;aACvB,CAAC,CACH,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC;gBAC7C,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC;gBAC/B,GAAG,EAAE,OAAO;aACb,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1C,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAExC,uBAAuB;YACvB,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;YAC/C,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,CAAC,wCAAwC,CAAC,CAAC;YAErE,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6BAA6B,EAAE,KAAK,IAAI,EAAE;YAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC/C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;YAEtD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC;gBAC7C,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,CAAC,SAAS,CAAC;gBAClB,GAAG,EAAE,OAAO;gBACZ,MAAM,EAAE,IAAI;aACb,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAExC,+BAA+B;YAC/B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;YACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC/C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,oBAAoB,CAAC,CAAC;YAEnD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC;gBAC7C,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,CAAC,SAAS,CAAC;gBAClB,GAAG,EAAE,OAAO;gBACZ,WAAW,EAAE,UAAU;aACxB,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAExC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;YAC/C,eAAe;YACf,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;YACvD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACvD,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC5B,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;YAE3D,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;YAChD,MAAM,EAAE,CAAC,SAAS,CAAC,YAAY,EAAE,aAAa,CAAC,CAAC;YAEhD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,UAAU,CAAC;gBAC7C,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,CAAC,SAAS,CAAC;gBAClB,OAAO,EAAE,CAAC,iBAAiB,CAAC;gBAC5B,GAAG,EAAE,OAAO;aACb,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAExC,wCAAwC;YACxC,MAAM,eAAe,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YACjE,MAAM,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;QACvB,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC/C,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,qCAAqC,CAAC,CAAC;YAEpE,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC;gBAC1C,OAAO,EAAE,OAAO;gBAChB,KAAK,EAAE,CAAC,SAAS,CAAC;gBAClB,GAAG,EAAE,OAAO;aACb,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAExC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,+CAA+C,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;YAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAC/C,MAAM,EAAE,CAAC,SAAS,CAChB,QAAQ,EACR,wCAAwC,CACzC,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC;gBAC1C,UAAU,EAAE,IAAI;gBAChB,KAAK,EAAE,CAAC,SAAS,CAAC;gBAClB,GAAG,EAAE,OAAO;aACb,CAAC,CAAC;YAEH,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAExC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACrD,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;QACtB,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;YACvD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;YACvD,MAAM,EAAE,CAAC,SAAS,CAChB,WAAW,EACX,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CACnD,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YAEnE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;YACvD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;YAClD,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;YAE5C,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;YAEnE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACtC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;YACxD,MAAM,MAAM,CACV,cAAc,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAC9C,CAAC,OAAO,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC;QAChE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/version-management/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,UAAU,EACV,aAAa,EACb,QAAQ,GACT,MAAM,wBAAwB,CAAC"}

package/dist/version-management/index.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/version-management/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Version Constants - Single Source of Truth
+ *
+ * NEVER hardcode versions in tests/examples/code.
+ * ALWAYS import from this file.
+ *
+ * This file is auto-generated during build from .version.json
+ */
+/**
+ * Current package version (e.g., "0.4.1")
+ */
+export declare const VERSION: string;
+/**
+ * Current spec version (e.g., "0.4.1")
+ */
+export declare const SPEC_VERSION: string;
+/**
+ * API version string for manifests (e.g., "ossa/v0.4.1")
+ */
+export declare const API_VERSION: string;
+/**
+ * Spec path (e.g., "spec/v0.4")
+ */
+export declare const SPEC_PATH: string;
+/**
+ * Schema filename (e.g., "agent.schema.json")
+ */
+export declare const SCHEMA_FILE: string;
+/**
+ * Full schema path
+ */
+export declare const SCHEMA_PATH: string;
+/**
+ * Get version data object
+ */
+export declare function getVersionData(): {
+    version: string;
+    specVersion: string;
+    apiVersion: string;
+    specPath: string;
+    schemaFile: string;
+    schemaPath: string;
+};
+/**
+ * Validate that a manifest uses the correct apiVersion
+ */
+export declare function validateApiVersion(apiVersion: string): boolean;
+/**
+ * For CommonJS compatibility
+ */
+declare const _default: {
+    VERSION: string;
+    SPEC_VERSION: string;
+    API_VERSION: string;
+    SPEC_PATH: string;
+    SCHEMA_FILE: string;
+    SCHEMA_PATH: string;
+    getVersionData: typeof getVersionData;
+    validateApiVersion: typeof validateApiVersion;
+};
+export default _default;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAaH;;GAEG;AACH,eAAO,MAAM,OAAO,EAA0B,MAAM,CAAC;AAErD;;GAEG;AACH,eAAO,MAAM,YAAY,EAA+B,MAAM,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,WAAW,QAA0B,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,SAAS,EAA4B,MAAM,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,WAAW,EAA8B,MAAM,CAAC;AAE7D;;GAEG;AACH,eAAO,MAAM,WAAW,QAAgC,CAAC;AAEzD;;GAEG;AACH,wBAAgB,cAAc;;;;;;;EAS7B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;GAEG;;;;;;;;;;;AACH,wBASE"}