@bluefly/openstandardagents 0.3.3 → 0.3.5

package/dist/dev-cli/src/services/agent-migration.service.js

@@ -0,0 +1,199 @@
+/**
+ * Agent Migration Service
+ *
+ * SOLID: Single Responsibility - Agent manifest migration only
+ * DRY: Uses .version.json as single source of truth
+ */
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { execSync } from 'child_process';
+import { MigrateAgentsRequestSchema, } from '../schemas/migrate.schema.js';
+import { VersionConfigSchema } from '../schemas/version.schema.js';
+import * as YAML from 'yaml';
+export class AgentMigrationService {
+    rootDir;
+    versionFile;
+    constructor(rootDir = process.cwd()) {
+        this.rootDir = rootDir;
+        this.versionFile = join(rootDir, '.version.json');
+    }
+    /**
+     * Migrate agent manifests to latest or specified version
+     * DYNAMIC: Uses .version.json for target version
+     */
+    async migrateAgents(request) {
+        // Validate request with Zod
+        const validated = MigrateAgentsRequestSchema.parse(request);
+        // Get target version from .version.json if not specified
+        const targetVersion = validated.targetVersion || this.getTargetVersion();
+        // Find all agent manifests
+        const agentFiles = this.findAgentManifests(validated.paths);
+        const results = [];
+        let upgraded = 0;
+        let skipped = 0;
+        let failed = 0;
+        for (const filePath of agentFiles) {
+            try {
+                const result = await this.upgradeAgent(filePath, targetVersion, validated.dryRun, validated.force);
+                results.push(result);
+                if (result.success) {
+                    if (result.oldVersion === result.newVersion) {
+                        skipped++;
+                    }
+                    else {
+                        upgraded++;
+                    }
+                }
+                else {
+                    failed++;
+                }
+            }
+            catch (error) {
+                results.push({
+                    path: filePath,
+                    success: false,
+                    oldVersion: 'unknown',
+                    newVersion: targetVersion,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                failed++;
+            }
+        }
+        return {
+            success: failed === 0,
+            targetVersion,
+            totalFiles: agentFiles.length,
+            upgraded,
+            skipped,
+            failed,
+            results,
+            dryRun: validated.dryRun,
+        };
+    }
+    /**
+     * Get target version from .version.json
+     */
+    getTargetVersion() {
+        if (!existsSync(this.versionFile)) {
+            throw new Error('.version.json not found. Run `ossa-dev version detect` first.');
+        }
+        const content = readFileSync(this.versionFile, 'utf-8');
+        const config = VersionConfigSchema.parse(JSON.parse(content));
+        return config.current;
+    }
+    /**
+     * Find all agent manifest files
+     * Searches for both .ossa.* files and agent files in specific directories
+     */
+    findAgentManifests(paths) {
+        const searchPaths = paths && paths.length > 0
+            ? paths
+            : ['.gitlab', '.ossa', 'examples', 'spec'];
+        const files = [];
+        for (const searchPath of searchPaths) {
+            const fullPath = join(this.rootDir, searchPath);
+            if (!existsSync(fullPath)) {
+                continue;
+            }
+            try {
+                // Find both .ossa.* files and plain .yaml/.yml/.json files in agent directories
+                const found = execSync(`find "${fullPath}" -type f \\( -name "*.ossa.yaml" -o -name "*.ossa.yml" -o -name "*.ossa.json" -o -name "*.yaml" -o -name "*.yml" -o -name "*.json" \\) | grep -v node_modules | grep -v dist | grep -v coverage`, {
+                    encoding: 'utf-8',
+                    cwd: this.rootDir,
+                })
+                    .trim()
+                    .split('\n')
+                    .filter(Boolean)
+                    .filter((file) => {
+                    // Only include files that look like agent manifests
+                    const content = readFileSync(file, 'utf-8').substring(0, 500);
+                    return (content.includes('apiVersion') &&
+                        content.includes('ossa/v') &&
+                        (content.includes('kind: Agent') ||
+                            content.includes('"kind": "Agent"')));
+                });
+                files.push(...found);
+            }
+            catch {
+                // Continue if find fails
+            }
+        }
+        return files;
+    }
+    /**
+     * Upgrade a single agent manifest
+     */
+    async upgradeAgent(filePath, targetVersion, dryRun, force) {
+        const content = readFileSync(filePath, 'utf-8');
+        const isYaml = filePath.endsWith('.yaml') || filePath.endsWith('.yml');
+        let manifest;
+        let oldVersion = 'unknown';
+        try {
+            manifest = isYaml ? YAML.parse(content) : JSON.parse(content);
+            oldVersion = this.extractVersion(manifest.apiVersion || '');
+        }
+        catch (error) {
+            return {
+                path: filePath,
+                success: false,
+                oldVersion,
+                newVersion: targetVersion,
+                error: `Failed to parse manifest: ${error instanceof Error ? error.message : String(error)}`,
+            };
+        }
+        // Check if already at target version
+        if (oldVersion === targetVersion && !force) {
+            return {
+                path: filePath,
+                success: true,
+                oldVersion,
+                newVersion: targetVersion,
+            };
+        }
+        // Update apiVersion using minor version only (e.g., ossa/v0.3 not ossa/v0.3.5)
+        const minorVersion = this.extractMinorVersion(targetVersion);
+        const newApiVersion = `ossa/v${minorVersion}`;
+        manifest.apiVersion = newApiVersion;
+        if (!dryRun) {
+            try {
+                const newContent = isYaml
+                    ? YAML.stringify(manifest)
+                    : JSON.stringify(manifest, null, 2) + '\n';
+                writeFileSync(filePath, newContent, 'utf-8');
+            }
+            catch (error) {
+                return {
+                    path: filePath,
+                    success: false,
+                    oldVersion,
+                    newVersion: targetVersion,
+                    error: `Failed to write manifest: ${error instanceof Error ? error.message : String(error)}`,
+                };
+            }
+        }
+        return {
+            path: filePath,
+            success: true,
+            oldVersion,
+            newVersion: targetVersion,
+        };
+    }
+    /**
+     * Extract version from apiVersion string (e.g., "ossa/v0.3.5" → "0.3.5")
+     */
+    extractVersion(apiVersion) {
+        const match = apiVersion.match(/ossa\/v(.+)/);
+        return match ? match[1] : 'unknown';
+    }
+    /**
+     * Extract minor version from full version (e.g., "0.3.5" → "0.3")
+     */
+    extractMinorVersion(version) {
+        const parts = version.split('.');
+        if (parts.length >= 2) {
+            return `${parts[0]}.${parts[1]}`;
+        }
+        return version;
+    }
+}
+//# sourceMappingURL=agent-migration.service.js.map

package/dist/dev-cli/src/services/agent-migration.service.js.map

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

package/dist/dev-cli/src/services/file.service.d.ts

@@ -0,0 +1,42 @@
+/**
+ * File Service
+ *
+ * SOLID: Single Responsibility - File I/O operations only
+ * DRY: Centralizes all file system operations
+ *
+ * Abstraction for file operations to eliminate duplication across services.
+ */
+import { z } from 'zod';
+export declare class FileService {
+    private readonly rootDir;
+    constructor(rootDir?: string);
+    /**
+     * Read JSON file with Zod validation
+     */
+    readJson<T>(filePath: string, schema: z.ZodSchema<T>): T;
+    /**
+     * Read JSON file without validation (returns unknown)
+     */
+    readJsonUnsafe(filePath: string): unknown;
+    /**
+     * Write JSON file
+     */
+    writeJson(filePath: string, data: unknown, pretty?: boolean): void;
+    /**
+     * Read text file
+     */
+    readText(filePath: string): string;
+    /**
+     * Write text file
+     */
+    writeText(filePath: string, content: string): void;
+    /**
+     * Check if file exists
+     */
+    exists(filePath: string): boolean;
+    /**
+     * Get full path relative to root
+     */
+    resolve(filePath: string): string;
+}
+//# sourceMappingURL=file.service.d.ts.map

package/dist/dev-cli/src/services/file.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.service.d.ts","sourceRoot":"","sources":["../../../../src/dev-cli/src/services/file.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,MAAsB;IAI3C;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;IAqBxD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAiBzC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAE,OAAc,GAAG,IAAI;IAgBxE;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAgBlC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAYlD;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKjC;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;CAGlC"}

package/dist/dev-cli/src/services/file.service.js

@@ -0,0 +1,109 @@
+/**
+ * File Service
+ *
+ * SOLID: Single Responsibility - File I/O operations only
+ * DRY: Centralizes all file system operations
+ *
+ * Abstraction for file operations to eliminate duplication across services.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { z } from 'zod';
+export class FileService {
+    rootDir;
+    constructor(rootDir = process.cwd()) {
+        this.rootDir = rootDir;
+    }
+    /**
+     * Read JSON file with Zod validation
+     */
+    readJson(filePath, schema) {
+        const fullPath = join(this.rootDir, filePath);
+        if (!existsSync(fullPath)) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        try {
+            const content = readFileSync(fullPath, 'utf-8');
+            const parsed = JSON.parse(content);
+            return schema.parse(parsed);
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                throw new Error(`Invalid JSON schema in ${filePath}: ${error.message}`);
+            }
+            throw new Error(`Failed to read JSON file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Read JSON file without validation (returns unknown)
+     */
+    readJsonUnsafe(filePath) {
+        const fullPath = join(this.rootDir, filePath);
+        if (!existsSync(fullPath)) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        try {
+            const content = readFileSync(fullPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch (error) {
+            throw new Error(`Failed to read JSON file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Write JSON file
+     */
+    writeJson(filePath, data, pretty = true) {
+        const fullPath = join(this.rootDir, filePath);
+        const dir = dirname(fullPath);
+        // Ensure directory exists
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        const content = pretty
+            ? JSON.stringify(data, null, 2) + '\n'
+            : JSON.stringify(data);
+        writeFileSync(fullPath, content, 'utf-8');
+    }
+    /**
+     * Read text file
+     */
+    readText(filePath) {
+        const fullPath = join(this.rootDir, filePath);
+        if (!existsSync(fullPath)) {
+            throw new Error(`File not found: ${filePath}`);
+        }
+        try {
+            return readFileSync(fullPath, 'utf-8');
+        }
+        catch (error) {
+            throw new Error(`Failed to read file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /**
+     * Write text file
+     */
+    writeText(filePath, content) {
+        const fullPath = join(this.rootDir, filePath);
+        const dir = dirname(fullPath);
+        // Ensure directory exists
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(fullPath, content, 'utf-8');
+    }
+    /**
+     * Check if file exists
+     */
+    exists(filePath) {
+        const fullPath = join(this.rootDir, filePath);
+        return existsSync(fullPath);
+    }
+    /**
+     * Get full path relative to root
+     */
+    resolve(filePath) {
+        return join(this.rootDir, filePath);
+    }
+}
+//# sourceMappingURL=file.service.js.map

package/dist/dev-cli/src/services/file.service.js.map

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

package/dist/dev-cli/src/services/git.service.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Git Service
+ *
+ * SOLID: Single Responsibility - Git operations only
+ * DRY: Centralizes all git command execution
+ *
+ * Abstraction for git operations to eliminate duplication across services.
+ */
+export interface GitTag {
+    name: string;
+    version: string;
+    isStable: boolean;
+    isRC: boolean;
+    isDev: boolean;
+}
+export interface GitRepositoryState {
+    remoteUrl: string;
+    currentBranch: string;
+    isClean: boolean;
+    hasUncommittedChanges: boolean;
+}
+export declare class GitService {
+    private readonly rootDir;
+    constructor(rootDir?: string);
+    /**
+     * Fetch all tags from remote
+     */
+    fetchTags(): Promise<void>;
+    /**
+     * Get all version tags (vX.Y.Z format)
+     */
+    getAllVersionTags(): Promise<GitTag[]>;
+    /**
+     * Get latest stable tag
+     */
+    getLatestStableTag(): Promise<GitTag | null>;
+    /**
+     * Get latest tag (any type)
+     */
+    getLatestTag(): Promise<GitTag | null>;
+    /**
+     * Get tags matching a pattern (e.g., "v0.3.*")
+     */
+    getTagsMatching(pattern: string): Promise<GitTag[]>;
+    /**
+     * Get current branch name
+     */
+    getCurrentBranch(): string;
+    /**
+     * Get remote URL
+     */
+    getRemoteUrl(remote?: string): string;
+    /**
+     * Check if working directory is clean
+     */
+    isClean(): boolean;
+    /**
+     * Get repository state
+     */
+    getRepositoryState(): Promise<GitRepositoryState>;
+    /**
+     * Create a git tag
+     */
+    createTag(tag: string, message: string): void;
+    /**
+     * Check if tag exists
+     */
+    tagExists(tag: string): boolean;
+    /**
+     * Get all remotes
+     */
+    getRemotes(): Array<{
+        name: string;
+        url: string;
+    }>;
+}
+//# sourceMappingURL=git.service.d.ts.map

package/dist/dev-cli/src/services/git.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.service.d.ts","sourceRoot":"","sources":["../../../../src/dev-cli/src/services/git.service.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,GAAE,MAAsB;IAI3C;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAWhC;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAyC5C;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKlD;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAK5C;;OAEG;IACG,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BzD;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAW1B;;OAEG;IACH,YAAY,CAAC,MAAM,GAAE,MAAiB,GAAG,MAAM;IAW/C;;OAEG;IACH,OAAO,IAAI,OAAO;IAYlB;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IASvD;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAY7C;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAY/B;;OAEG;IACH,UAAU,IAAI,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CA2BnD"}

package/dist/dev-cli/src/services/git.service.js

@@ -0,0 +1,226 @@
+/**
+ * Git Service
+ *
+ * SOLID: Single Responsibility - Git operations only
+ * DRY: Centralizes all git command execution
+ *
+ * Abstraction for git operations to eliminate duplication across services.
+ */
+import { execSync } from 'child_process';
+export class GitService {
+    rootDir;
+    constructor(rootDir = process.cwd()) {
+        this.rootDir = rootDir;
+    }
+    /**
+     * Fetch all tags from remote
+     */
+    async fetchTags() {
+        try {
+            execSync('git fetch --tags --prune origin', {
+                cwd: this.rootDir,
+                stdio: 'ignore',
+            });
+        }
+        catch {
+            // Continue if fetch fails (not a git repo, no remote, etc.)
+        }
+    }
+    /**
+     * Get all version tags (vX.Y.Z format)
+     */
+    async getAllVersionTags() {
+        try {
+            const tags = execSync('git tag -l "v*"', {
+                cwd: this.rootDir,
+                encoding: 'utf-8',
+                stdio: ['ignore', 'pipe', 'ignore'],
+            })
+                .trim()
+                .split('\n')
+                .filter(Boolean)
+                .map((tag) => tag.trim());
+            return tags
+                .map((tag) => {
+                const version = tag.replace(/^v/, '');
+                return {
+                    name: tag,
+                    version,
+                    isStable: /^\d+\.\d+\.\d+$/.test(version) && !version.includes('-'),
+                    isRC: version.includes('-rc'),
+                    isDev: version.includes('-dev'),
+                };
+            })
+                .sort((a, b) => {
+                // Sort by version (newest first)
+                const aParts = a.version.split(/[.-]/).map(Number);
+                const bParts = b.version.split(/[.-]/).map(Number);
+                for (let i = 0; i < Math.max(aParts.length, bParts.length); i++) {
+                    const aVal = aParts[i] ?? 0;
+                    const bVal = bParts[i] ?? 0;
+                    if (aVal > bVal)
+                        return -1;
+                    if (aVal < bVal)
+                        return 1;
+                }
+                return 0;
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Get latest stable tag
+     */
+    async getLatestStableTag() {
+        const tags = await this.getAllVersionTags();
+        return tags.find((tag) => tag.isStable) || null;
+    }
+    /**
+     * Get latest tag (any type)
+     */
+    async getLatestTag() {
+        const tags = await this.getAllVersionTags();
+        return tags[0] || null;
+    }
+    /**
+     * Get tags matching a pattern (e.g., "v0.3.*")
+     */
+    async getTagsMatching(pattern) {
+        try {
+            const tags = execSync(`git tag -l "${pattern}"`, {
+                cwd: this.rootDir,
+                encoding: 'utf-8',
+            })
+                .trim()
+                .split('\n')
+                .filter(Boolean)
+                .map((tag) => tag.trim());
+            return tags.map((tag) => {
+                const version = tag.replace(/^v/, '');
+                return {
+                    name: tag,
+                    version,
+                    isStable: /^\d+\.\d+\.\d+$/.test(version) && !version.includes('-'),
+                    isRC: version.includes('-rc'),
+                    isDev: version.includes('-dev'),
+                };
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    /**
+     * Get current branch name
+     */
+    getCurrentBranch() {
+        try {
+            return execSync('git rev-parse --abbrev-ref HEAD', {
+                cwd: this.rootDir,
+                encoding: 'utf-8',
+            }).trim();
+        }
+        catch {
+            return 'unknown';
+        }
+    }
+    /**
+     * Get remote URL
+     */
+    getRemoteUrl(remote = 'origin') {
+        try {
+            return execSync(`git remote get-url ${remote}`, {
+                cwd: this.rootDir,
+                encoding: 'utf-8',
+            }).trim();
+        }
+        catch {
+            return '';
+        }
+    }
+    /**
+     * Check if working directory is clean
+     */
+    isClean() {
+        try {
+            const status = execSync('git status --porcelain', {
+                cwd: this.rootDir,
+                encoding: 'utf-8',
+            }).trim();
+            return status.length === 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get repository state
+     */
+    async getRepositoryState() {
+        return {
+            remoteUrl: this.getRemoteUrl(),
+            currentBranch: this.getCurrentBranch(),
+            isClean: this.isClean(),
+            hasUncommittedChanges: !this.isClean(),
+        };
+    }
+    /**
+     * Create a git tag
+     */
+    createTag(tag, message) {
+        // Validate tag format
+        if (!/^v\d+\.\d+\.\d+/.test(tag)) {
+            throw new Error(`Invalid tag format: ${tag}. Must be vX.Y.Z format.`);
+        }
+        execSync(`git tag -a ${tag} -m "${message}"`, {
+            cwd: this.rootDir,
+            stdio: 'inherit',
+        });
+    }
+    /**
+     * Check if tag exists
+     */
+    tagExists(tag) {
+        try {
+            const output = execSync(`git tag -l "${tag}"`, {
+                cwd: this.rootDir,
+                encoding: 'utf-8',
+            }).trim();
+            return output.length > 0;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Get all remotes
+     */
+    getRemotes() {
+        try {
+            const output = execSync('git remote -v', {
+                cwd: this.rootDir,
+                encoding: 'utf-8',
+            }).trim();
+            const remotes = [];
+            const seen = new Set();
+            for (const line of output.split('\n')) {
+                const match = line.match(/^(\S+)\s+(\S+)/);
+                if (match) {
+                    const name = match[1];
+                    const url = match[2];
+                    if (!seen.has(name)) {
+                        remotes.push({ name, url });
+                        seen.add(name);
+                    }
+                }
+            }
+            return remotes;
+        }
+        catch {
+            return [];
+        }
+    }
+}
+//# sourceMappingURL=git.service.js.map