@bluefly/openstandardagents 0.2.9 → 0.3.1

package/dist/cli/commands/deploy.js

@@ -0,0 +1,319 @@
+/**
+ * OSSA Deploy and Status Commands
+ * Enhanced deployment and lifecycle management with runtime drivers
+ */
+import chalk from 'chalk';
+import { Command } from 'commander';
+import { readFileSync } from 'fs';
+import { container } from '../../di-container.js';
+import { ManifestRepository } from '../../repositories/manifest.repository.js';
+import { ValidationService } from '../../services/validation.service.js';
+import { createDeploymentDriver, } from '../../deploy/index.js';
+/**
+ * Load deployment configuration from file
+ */
+function loadConfig(configPath) {
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        throw new Error(`Failed to load config file: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Deploy command - deploy agent to runtime
+ */
+export const deployCommand = new Command('deploy')
+    .argument('<path>', 'Path to agent manifest')
+    .option('--target <target>', 'Deployment target (local|docker|kubernetes)', 'local')
+    .option('--env <environment>', 'Target environment', 'dev')
+    .option('--version <version>', 'Version to deploy')
+    .option('--config <config-file>', 'Configuration file path')
+    .option('--dry-run', 'Simulate deployment without executing', false)
+    .option('--port <port>', 'Port number for local/docker deployment')
+    .option('--docker-image <image>', 'Docker image to use')
+    .option('--docker-network <network>', 'Docker network', 'bridge')
+    .option('--namespace <namespace>', 'Kubernetes namespace', 'default')
+    .option('--replicas <count>', 'Number of replicas (K8s)', '1')
+    .description('Deploy agent to specified runtime')
+    .action(async (manifestPath, options) => {
+    try {
+        // Validate target
+        const validTargets = ['local', 'docker', 'kubernetes'];
+        const target = options.target;
+        if (!validTargets.includes(target)) {
+            console.error(chalk.red(`✗ Invalid target: ${options.target}`), chalk.gray(`\n  Valid targets: ${validTargets.join(', ')}`));
+            process.exit(1);
+        }
+        // Load and validate manifest
+        const manifestRepo = container.get(ManifestRepository);
+        const validationService = container.get(ValidationService);
+        console.log(chalk.blue(`Loading agent manifest: ${manifestPath}`));
+        const manifest = await manifestRepo.load(manifestPath);
+        const result = await validationService.validate(manifest);
+        if (!result.valid) {
+            console.error(chalk.red('✗ Manifest validation failed:'));
+            result.errors.forEach((error) => console.error(chalk.red(`  - ${error.message}`)));
+            process.exit(1);
+        }
+        console.log(chalk.green('✓ Manifest is valid'));
+        // Build deployment config
+        let deployConfig = {
+            target,
+            environment: options.env,
+            version: options.version,
+            dryRun: options.dryRun,
+        };
+        // Load config file if provided
+        if (options.config) {
+            console.log(chalk.blue(`Loading config from: ${options.config}`));
+            const fileConfig = loadConfig(options.config);
+            deployConfig = { ...deployConfig, ...fileConfig };
+        }
+        // Apply CLI options (override config file)
+        if (options.port) {
+            const port = parseInt(options.port);
+            if (isNaN(port) || port <= 0 || port > 65535) {
+                console.error(chalk.red(`✗ Invalid port: ${options.port}`));
+                process.exit(1);
+            }
+            deployConfig.port = port;
+        }
+        if (options.dockerImage)
+            deployConfig.dockerImage = options.dockerImage;
+        if (options.dockerNetwork)
+            deployConfig.dockerNetwork = options.dockerNetwork;
+        if (options.namespace)
+            deployConfig.namespace = options.namespace;
+        if (options.replicas) {
+            const replicas = parseInt(options.replicas);
+            if (isNaN(replicas) || replicas <= 0) {
+                console.error(chalk.red(`✗ Invalid replicas count: ${options.replicas}`));
+                process.exit(1);
+            }
+            deployConfig.replicas = replicas;
+        }
+        // Create driver and deploy
+        console.log(chalk.blue(`\nDeploying to ${chalk.bold(target)} runtime...`));
+        if (deployConfig.dryRun) {
+            console.log(chalk.yellow('Running in DRY RUN mode\n'));
+        }
+        const driver = createDeploymentDriver(target);
+        const deployResult = await driver.deploy(manifest, deployConfig);
+        if (deployResult.success) {
+            console.log(chalk.green(`\n✓ ${deployResult.message}`));
+            if (deployResult.instanceId) {
+                console.log(chalk.cyan(`  Instance ID: ${deployResult.instanceId}`));
+            }
+            if (deployResult.endpoint) {
+                console.log(chalk.cyan(`  Endpoint: ${deployResult.endpoint}`));
+            }
+            if (deployResult.metadata) {
+                console.log(chalk.gray('\n  Deployment details:'));
+                Object.entries(deployResult.metadata).forEach(([key, value]) => {
+                    console.log(chalk.gray(`    ${key}: ${typeof value === 'object' ? JSON.stringify(value, null, 2).split('\n').join('\n    ') : value}`));
+                });
+            }
+            // Update manifest with deployment info
+            if (!manifest.spec) {
+                manifest.spec = { role: 'unknown' };
+            }
+            if (!manifest.spec.environments) {
+                manifest.spec.environments = {};
+            }
+            manifest.spec.environments[deployConfig.environment] = {
+                version: deployConfig.version || manifest.metadata?.version || '1.0.0',
+                deployedAt: new Date().toISOString(),
+                deployedBy: process.env.USER || 'unknown',
+                status: 'deployed',
+                endpoint: deployResult.endpoint,
+            };
+            await manifestRepo.save(manifestPath, manifest);
+            process.exit(0);
+        }
+        else {
+            console.error(chalk.red(`\n✗ ${deployResult.message}`));
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('✗ Deployment failed:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+/**
+ * Status command - check deployment status
+ */
+export const statusCommand = new Command('status')
+    .option('--target <target>', 'Deployment target (local|docker|kubernetes)', 'local')
+    .option('--instance <id>', 'Specific instance ID')
+    .option('--list', 'List all running instances')
+    .option('--health', 'Include health metrics')
+    .description('Check agent deployment status')
+    .action(async (options) => {
+    try {
+        const validTargets = ['local', 'docker', 'kubernetes'];
+        const target = options.target;
+        if (!validTargets.includes(target)) {
+            console.error(chalk.red(`✗ Invalid target: ${options.target}`));
+            process.exit(1);
+        }
+        const driver = createDeploymentDriver(target);
+        if (options.list) {
+            // List all instances
+            console.log(chalk.cyan.bold(`\nRunning Instances (${target}):\n`));
+            const instances = await driver.listInstances();
+            if (instances.length === 0) {
+                console.log(chalk.yellow('  No running instances found'));
+                return;
+            }
+            for (const instance of instances) {
+                const statusColor = instance.status === 'running'
+                    ? chalk.green
+                    : instance.status === 'failed'
+                        ? chalk.red
+                        : chalk.yellow;
+                console.log(chalk.cyan(`  ${instance.name}`));
+                console.log(`    ID:       ${instance.id}`);
+                console.log(`    Status:   ${statusColor(instance.status)}`);
+                console.log(`    Version:  ${instance.version}`);
+                console.log(`    Deployed: ${new Date(instance.deployedAt).toLocaleString()}`);
+                if (instance.endpoint) {
+                    console.log(`    Endpoint: ${instance.endpoint}`);
+                }
+                if (options.health && instance.health) {
+                    const healthColor = instance.health.healthy
+                        ? chalk.green
+                        : chalk.red;
+                    console.log(`    Health:   ${healthColor(instance.health.status)}`);
+                    if (instance.health.metrics?.uptime !== undefined) {
+                        console.log(`    Uptime:   ${Math.floor(instance.health.metrics.uptime / 60)}m`);
+                    }
+                }
+                console.log('');
+            }
+        }
+        else if (options.instance) {
+            // Get specific instance status
+            const instance = await driver.getStatus(options.instance);
+            console.log(chalk.cyan.bold(`\nInstance Status:\n`));
+            console.log(chalk.cyan(`  ${instance.name}`));
+            console.log(`  ID:       ${instance.id}`);
+            const statusColor = instance.status === 'running'
+                ? chalk.green
+                : instance.status === 'failed'
+                    ? chalk.red
+                    : chalk.yellow;
+            console.log(`  Status:   ${statusColor(instance.status)}`);
+            console.log(`  Version:  ${instance.version}`);
+            console.log(`  Deployed: ${new Date(instance.deployedAt).toLocaleString()}`);
+            if (instance.endpoint) {
+                console.log(`  Endpoint: ${instance.endpoint}`);
+            }
+            // Show health metrics
+            if (options.health) {
+                console.log(chalk.cyan.bold('\n  Health Metrics:'));
+                const health = await driver.healthCheck(options.instance);
+                const healthColor = health.healthy ? chalk.green : chalk.red;
+                console.log(`    Status:  ${healthColor(health.status)}`);
+                if (health.message) {
+                    console.log(`    Message: ${health.message}`);
+                }
+                if (health.metrics) {
+                    const uptime = health.metrics.uptime ?? 0;
+                    const memoryUsage = health.metrics.memoryUsage ?? 0;
+                    const cpuUsage = health.metrics.cpuUsage ?? 0;
+                    const errorRate = health.metrics.errorRate ?? 0;
+                    console.log(`    Uptime:  ${Math.floor(uptime / 60)}m ${uptime % 60}s`);
+                    console.log(`    Memory:  ${memoryUsage.toFixed(2)}%`);
+                    console.log(`    CPU:     ${cpuUsage.toFixed(2)}%`);
+                    console.log(`    Errors:  ${errorRate.toFixed(2)}%`);
+                }
+            }
+            // Show metadata
+            if (instance.metadata) {
+                console.log(chalk.cyan.bold('\n  Metadata:'));
+                Object.entries(instance.metadata).forEach(([key, value]) => {
+                    console.log(`    ${key}: ${value}`);
+                });
+            }
+        }
+        else {
+            console.error(chalk.red('✗ Please specify --instance <id> or --list'));
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('✗ Status check failed:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+/**
+ * Rollback command - rollback to previous version
+ */
+export const rollbackCommand = new Command('rollback')
+    .argument('<instance-id>', 'Instance ID to rollback')
+    .option('--target <target>', 'Deployment target (local|docker|kubernetes)', 'local')
+    .option('--to-version <version>', 'Specific version to rollback to')
+    .option('--steps <number>', 'Number of versions to rollback', '1')
+    .description('Rollback agent to previous version')
+    .action(async (instanceId, options) => {
+    try {
+        const validTargets = ['local', 'docker', 'kubernetes'];
+        const target = options.target;
+        if (!validTargets.includes(target)) {
+            console.error(chalk.red(`✗ Invalid target: ${options.target}`));
+            process.exit(1);
+        }
+        const driver = createDeploymentDriver(target);
+        console.log(chalk.blue(`Rolling back instance: ${instanceId}...`));
+        const result = await driver.rollback(instanceId, {
+            toVersion: options.toVersion,
+            steps: options.steps ? parseInt(options.steps) : 1,
+        });
+        if (result.success) {
+            console.log(chalk.green(`\n✓ ${result.message}`));
+            if (result.metadata) {
+                console.log(chalk.gray('\n  Rollback details:'));
+                Object.entries(result.metadata).forEach(([key, value]) => {
+                    console.log(chalk.gray(`    ${key}: ${value}`));
+                });
+            }
+        }
+        else {
+            console.error(chalk.red(`\n✗ ${result.message}`));
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('✗ Rollback failed:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+/**
+ * Stop command - stop a running instance
+ */
+export const stopCommand = new Command('stop')
+    .argument('<instance-id>', 'Instance ID to stop')
+    .option('--target <target>', 'Deployment target (local|docker|kubernetes)', 'local')
+    .description('Stop a running agent instance')
+    .action(async (instanceId, options) => {
+    try {
+        const validTargets = ['local', 'docker', 'kubernetes'];
+        const target = options.target;
+        if (!validTargets.includes(target)) {
+            console.error(chalk.red(`✗ Invalid target: ${options.target}`));
+            process.exit(1);
+        }
+        const driver = createDeploymentDriver(target);
+        console.log(chalk.blue(`Stopping instance: ${instanceId}...`));
+        await driver.stop(instanceId);
+        console.log(chalk.green(`✓ Instance stopped successfully`));
+    }
+    catch (error) {
+        console.error(chalk.red('✗ Stop failed:'), error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=deploy.js.map

package/dist/cli/commands/deploy.js.map

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

package/dist/cli/commands/diff.command.d.ts

@@ -0,0 +1,7 @@
+/**
+ * OSSA Diff Command
+ * Compare OSSA agent manifests between files or git references
+ */
+import { Command } from 'commander';
+export declare const diffCommand: Command;
+//# sourceMappingURL=diff.command.d.ts.map

package/dist/cli/commands/diff.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.command.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/diff.command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoEpC,eAAO,MAAM,WAAW,SAsIrB,CAAC"}

package/dist/cli/commands/diff.command.js

@@ -0,0 +1,181 @@
+/**
+ * OSSA Diff Command
+ * Compare OSSA agent manifests between files or git references
+ */
+import chalk from 'chalk';
+import { Command } from 'commander';
+import * as fs from 'fs';
+import { container } from '../../di-container.js';
+import { ManifestRepository } from '../../repositories/manifest.repository.js';
+import { GitService } from '../../services/git.service.js';
+function deepDiff(obj1, obj2, prefix = '') {
+    const changes = [];
+    const allKeys = new Set([...Object.keys(obj1 || {}), ...Object.keys(obj2 || {})]);
+    for (const key of allKeys) {
+        const path = prefix ? `${prefix}.${key}` : key;
+        const val1 = obj1?.[key];
+        const val2 = obj2?.[key];
+        if (!(key in obj1)) {
+            changes.push({
+                type: 'added',
+                path,
+                newValue: val2,
+                message: `Added: ${path}`,
+            });
+        }
+        else if (!(key in obj2)) {
+            changes.push({
+                type: 'removed',
+                path,
+                oldValue: val1,
+                message: `Removed: ${path}`,
+            });
+        }
+        else if (typeof val1 === 'object' && typeof val2 === 'object' && val1 !== null && val2 !== null && !Array.isArray(val1) && !Array.isArray(val2)) {
+            changes.push(...deepDiff(val1, val2, path));
+        }
+        else if (JSON.stringify(val1) !== JSON.stringify(val2)) {
+            changes.push({
+                type: 'modified',
+                path,
+                oldValue: val1,
+                newValue: val2,
+                message: `Modified: ${path}`,
+            });
+        }
+    }
+    return changes;
+}
+function isBreakingChange(change) {
+    // Breaking changes: removed fields, modified required fields, type changes
+    if (change.type === 'removed')
+        return true;
+    if (change.path.includes('metadata.name') || change.path.includes('metadata.version'))
+        return true;
+    if (change.path.includes('spec.role'))
+        return true;
+    if (change.path.includes('apiVersion'))
+        return true;
+    return false;
+}
+export const diffCommand = new Command('diff')
+    .argument('<path1>', 'First manifest path or git ref (e.g., main:path/to/file.yaml)')
+    .argument('[path2]', 'Second manifest path or git ref (default: current file)')
+    .option('--breaking-only', 'Show only breaking changes')
+    .option('--format <format>', 'Output format (default, json)', 'default')
+    .option('-o, --output <file>', 'Output file (for json format)')
+    .description('Compare OSSA agent manifests between versions')
+    .action(async (path1, path2, options) => {
+    try {
+        const manifestRepo = container.get(ManifestRepository);
+        const gitService = container.get(GitService);
+        // Parse git refs (format: ref:path)
+        let manifest1;
+        let manifest2;
+        let filePath1;
+        let filePath2;
+        // Load first manifest
+        const gitRef1 = gitService.parseRefString(path1);
+        if (gitRef1) {
+            try {
+                manifest1 = gitService.loadManifestFromRef(gitRef1.ref, gitRef1.filePath);
+                filePath1 = `${gitRef1.ref}:${gitRef1.filePath}`;
+            }
+            catch (error) {
+                console.error(chalk.red(`Failed to load ${path1} from git: ${error instanceof Error ? error.message : String(error)}`));
+                process.exit(1);
+            }
+        }
+        else {
+            manifest1 = await manifestRepo.load(path1);
+            filePath1 = path1;
+        }
+        // Load second manifest
+        if (path2) {
+            const gitRef2 = gitService.parseRefString(path2);
+            if (gitRef2) {
+                try {
+                    manifest2 = gitService.loadManifestFromRef(gitRef2.ref, gitRef2.filePath);
+                    filePath2 = `${gitRef2.ref}:${gitRef2.filePath}`;
+                }
+                catch (error) {
+                    console.error(chalk.red(`Failed to load ${path2} from git: ${error instanceof Error ? error.message : String(error)}`));
+                    process.exit(1);
+                }
+            }
+            else {
+                manifest2 = await manifestRepo.load(path2);
+                filePath2 = path2;
+            }
+        }
+        else {
+            // Compare with current file
+            manifest2 = await manifestRepo.load(filePath1);
+            filePath2 = filePath1;
+        }
+        // Compute diff
+        const changes = deepDiff(manifest1, manifest2);
+        const breakingChanges = changes.filter(isBreakingChange);
+        const result = {
+            breaking: breakingChanges.length > 0,
+            changes: options.breakingOnly ? breakingChanges : changes,
+        };
+        // Output results
+        if (options.format === 'json') {
+            const output = JSON.stringify(result, null, 2);
+            if (options.output) {
+                fs.writeFileSync(options.output, output);
+                console.log(chalk.green(`Results written to ${options.output}`));
+            }
+            else {
+                console.log(output);
+            }
+        }
+        else {
+            console.log(chalk.blue(`\nComparing manifests:`));
+            console.log(`  ${chalk.cyan(filePath1)}`);
+            console.log(`  ${chalk.cyan(filePath2 || filePath1)}\n`);
+            if (result.changes.length === 0) {
+                console.log(chalk.green('No differences found'));
+            }
+            else {
+                if (result.breaking) {
+                    console.log(chalk.red(`⚠️  ${breakingChanges.length} breaking change(s) detected\n`));
+                }
+                console.log(chalk.blue(`Found ${result.changes.length} change(s):\n`));
+                for (const change of result.changes) {
+                    const color = change.type === 'added'
+                        ? chalk.green
+                        : change.type === 'removed'
+                            ? chalk.red
+                            : chalk.yellow;
+                    const icon = change.type === 'added' ? '+' : change.type === 'removed' ? '-' : '~';
+                    const breaking = isBreakingChange(change) ? chalk.red(' [BREAKING]') : '';
+                    console.log(color(`${icon} ${change.message}${breaking}`));
+                    if (change.oldValue !== undefined && change.newValue !== undefined) {
+                        console.log(chalk.gray(`    Old: ${JSON.stringify(change.oldValue)}`));
+                        console.log(chalk.gray(`    New: ${JSON.stringify(change.newValue)}`));
+                    }
+                    else if (change.oldValue !== undefined) {
+                        console.log(chalk.gray(`    Value: ${JSON.stringify(change.oldValue)}`));
+                    }
+                    else if (change.newValue !== undefined) {
+                        console.log(chalk.gray(`    Value: ${JSON.stringify(change.newValue)}`));
+                    }
+                }
+                if (result.breaking) {
+                    console.log(chalk.red(`\n⚠️  Breaking changes detected - migration may be required`));
+                }
+            }
+        }
+        process.exit(result.breaking ? 1 : 0);
+    }
+    catch (error) {
+        console.error(chalk.red('[ERROR]'), error.message);
+        if (error.stack) {
+            console.error(chalk.gray(error.stack));
+        }
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=diff.command.js.map

package/dist/cli/commands/diff.command.js.map

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

package/dist/cli/commands/docs.command.d.ts

@@ -0,0 +1,7 @@
+/**
+ * OSSA Docs Command
+ * Generate documentation from agent manifests
+ */
+import { Command } from 'commander';
+export declare const docsCommand: Command;
+//# sourceMappingURL=docs.command.d.ts.map

package/dist/cli/commands/docs.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.command.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/docs.command.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmNpC,eAAO,MAAM,WAAW,SA4FrB,CAAC"}