@bluefly/openstandardagents 0.2.4 → 0.2.7

package/scripts/enhanced-version-manager.ts

@@ -0,0 +1,257 @@
+#!/usr/bin/env tsx
+/**
+ * Enhanced Version Manager Script
+ * 
+ * Integrates with GitLab agents for automated version management.
+ * Can run standalone or be invoked by GitLab agents.
+ * 
+ * Features:
+ * - GitLab API integration for milestone-based versioning
+ * - Automated MR creation
+ * - Version consistency validation
+ * - Documentation template processing
+ * - GitLab agent orchestration
+ */
+
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+import { z } from 'zod';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+// ============================================================================
+// Configuration
+// ============================================================================
+
+const VERSION_FILE = path.join(process.cwd(), '.version.json');
+const GITLAB_API_URL = process.env.CI_API_V4_URL || process.env.GITLAB_API_URL || 'https://gitlab.com/api/v4';
+// Use service account token (preferred) or fallback to user token
+const GITLAB_TOKEN = process.env.SERVICE_ACCOUNT_VERSION_MANAGER_TOKEN || 
+                      process.env.GITLAB_TOKEN || 
+                      process.env.GITLAB_PUSH_TOKEN || '';
+const PROJECT_ID = process.env.CI_PROJECT_ID || '';
+
+// ============================================================================
+// Zod Schemas
+// ============================================================================
+
+const VersionConfigSchema = z.object({
+  current: z.string(),
+  latest_stable: z.string(),
+  spec_path: z.string(),
+  schema_file: z.string(),
+});
+
+const BumpTypeSchema = z.enum(['major', 'minor', 'patch', 'rc', 'release']);
+
+type VersionConfig = z.infer<typeof VersionConfigSchema>;
+type BumpType = z.infer<typeof BumpTypeSchema>;
+
+// ============================================================================
+// Version Management
+// ============================================================================
+
+function getVersionConfig(): VersionConfig {
+  if (!fs.existsSync(VERSION_FILE)) {
+    throw new Error('.version.json not found');
+  }
+  const config = JSON.parse(fs.readFileSync(VERSION_FILE, 'utf-8'));
+  return VersionConfigSchema.parse(config);
+}
+
+function bumpVersion(current: string, type: BumpType): string {
+  const rcMatch = current.match(/^(\d+)\.(\d+)\.(\d+)-RC$/);
+  if (rcMatch) {
+    if (type === 'release') {
+      return `${rcMatch[1]}.${rcMatch[2]}.${rcMatch[3]}`;
+    }
+  }
+  
+  const match = current.match(/^(\d+)\.(\d+)\.(\d+)$/);
+  if (!match) throw new Error(`Invalid version format: ${current}`);
+  
+  let [, major, minor, patch] = match.map(Number);
+  
+  switch (type) {
+    case 'major':
+      return `${major + 1}.0.0`;
+    case 'minor':
+      return `${major}.${minor + 1}.0`;
+    case 'patch':
+      return `${major}.${minor}.${patch + 1}`;
+    case 'rc':
+      return `${major}.${minor}.${patch + 1}-RC`;
+    default:
+      throw new Error(`Unknown bump type: ${type}`);
+  }
+}
+
+// ============================================================================
+// GitLab Integration
+// ============================================================================
+
+async function getMilestoneVersion(milestoneId?: string): Promise<string | null> {
+  if (!milestoneId || !GITLAB_TOKEN || !PROJECT_ID) {
+    return null;
+  }
+
+  try {
+    const response = await fetch(
+      `${GITLAB_API_URL}/projects/${PROJECT_ID}/milestones/${milestoneId}`,
+      {
+        headers: {
+          'PRIVATE-TOKEN': GITLAB_TOKEN,
+        },
+      }
+    );
+
+    if (!response.ok) return null;
+
+    const milestone = await response.json();
+    const title = milestone.title || '';
+    
+    // Extract version from milestone title (e.g., "v0.2.6" or "0.2.6")
+    const versionMatch = title.match(/(\d+\.\d+\.\d+)/);
+    return versionMatch ? versionMatch[1] : null;
+  } catch (error) {
+    console.warn('Failed to fetch milestone:', error);
+    return null;
+  }
+}
+
+async function createMergeRequest(
+  sourceBranch: string,
+  targetBranch: string,
+  title: string,
+  description: string
+): Promise<number | null> {
+  if (!GITLAB_TOKEN || !PROJECT_ID) {
+    console.warn('GitLab credentials not available, skipping MR creation');
+    return null;
+  }
+
+  try {
+    const response = await fetch(
+      `${GITLAB_API_URL}/projects/${PROJECT_ID}/merge_requests`,
+      {
+        method: 'POST',
+        headers: {
+          'PRIVATE-TOKEN': GITLAB_TOKEN,
+          'Content-Type': 'application/json',
+        },
+        body: JSON.stringify({
+          source_branch: sourceBranch,
+          target_branch: targetBranch,
+          title,
+          description,
+          labels: ['version-bump', 'automated', 'chore'],
+          remove_source_branch: true,
+        }),
+      }
+    );
+
+    if (!response.ok) {
+      const error = await response.text();
+      throw new Error(`Failed to create MR: ${error}`);
+    }
+
+    const mr = await response.json();
+    return mr.iid;
+  } catch (error) {
+    console.error('Failed to create merge request:', error);
+    return null;
+  }
+}
+
+// ============================================================================
+// Main Execution
+// ============================================================================
+
+async function main() {
+  const args = process.argv.slice(2);
+  const bumpType = BumpTypeSchema.parse(args[0] || 'patch');
+  const milestoneId = process.env.CI_MILESTONE_ID || args[1];
+
+  console.log('🤖 Enhanced Version Manager');
+  console.log('===========================\n');
+
+  const config = getVersionConfig();
+  console.log(`📦 Current version: ${config.current}`);
+
+  // Try to get version from milestone
+  let targetVersion: string | null = null;
+  if (milestoneId) {
+    targetVersion = await getMilestoneVersion(milestoneId);
+    if (targetVersion) {
+      console.log(`🎯 Milestone version: ${targetVersion}`);
+    }
+  }
+
+  // Calculate new version
+  const newVersion = targetVersion || bumpVersion(config.current, bumpType);
+  console.log(`🚀 New version: ${newVersion}\n`);
+
+  // Update .version.json
+  config.latest_stable = config.current.replace('-RC', '');
+  config.current = newVersion;
+  fs.writeFileSync(VERSION_FILE, JSON.stringify(config, null, 2) + '\n');
+  console.log('✅ Updated .version.json');
+
+  // Run sync
+  console.log('\n📝 Syncing version references...');
+  execSync('npm run version:sync', { stdio: 'inherit' });
+
+  // Process docs
+  console.log('\n📚 Processing documentation templates...');
+  execSync('npm run docs:process', { stdio: 'inherit' });
+
+  // Validate
+  console.log('\n🔍 Validating version consistency...');
+  try {
+    execSync('npm run version:sync -- --check', { stdio: 'inherit' });
+    console.log('✅ Version consistency validated');
+  } catch (error) {
+    console.error('❌ Version consistency check failed');
+    process.exit(1);
+  }
+
+  // Git operations (if in CI or explicitly requested)
+  if (process.env.CI || process.argv.includes('--create-mr')) {
+    const targetBranch = process.env.CI_MERGE_REQUEST_TARGET_BRANCH_NAME || 'development';
+    const sourceBranch = `chore/version-bump-${newVersion}`;
+
+    console.log(`\n🌿 Creating branch: ${sourceBranch}`);
+    execSync(`git checkout -b ${sourceBranch}`, { stdio: 'inherit' });
+
+    console.log('\n📝 Committing changes...');
+    execSync('git add .', { stdio: 'inherit' });
+    execSync(`git commit -m "chore: bump version to ${newVersion}"`, { stdio: 'inherit' });
+
+    console.log('\n⬆️  Pushing branch...');
+    execSync(`git push -u origin ${sourceBranch}`, { stdio: 'inherit' });
+
+    console.log('\n🔀 Creating merge request...');
+    const mrId = await createMergeRequest(
+      sourceBranch,
+      targetBranch,
+      `chore: bump version to ${newVersion}`,
+      `Automated version bump to ${newVersion}\n\nTriggered by: ${milestoneId ? 'Milestone' : 'Manual'}\n\nChanges:\n- Updated .version.json\n- Synced package.json files\n- Updated documentation\n- Created spec/v${newVersion}/ directory`
+    );
+
+    if (mrId) {
+      console.log(`✅ Merge request created: !${mrId}`);
+    }
+  }
+
+  console.log('\n✅ Version management complete!');
+  console.log(`   ${config.current} → ${newVersion}`);
+}
+
+main().catch((error) => {
+  console.error('❌ Error:', error);
+  process.exit(1);
+});
+

package/scripts/fix-schema-formats.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+
+/**
+ * Fix unsupported format constraints in JSON schemas
+ * Removes format constraints that aren't supported by ajv-cli
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const UNSUPPORTED_FORMATS = ['uri'];
+const SPEC_DIR = path.join(__dirname, '..', 'spec');
+
+function fixSchema(schemaPath) {
+  const content = fs.readFileSync(schemaPath, 'utf8');
+  const schema = JSON.parse(content);
+  
+  let fixed = false;
+  
+  function walk(obj) {
+    if (typeof obj !== 'object' || obj === null) return;
+    
+    if (obj.format && UNSUPPORTED_FORMATS.includes(obj.format)) {
+      delete obj.format;
+      fixed = true;
+    }
+    
+    for (const key in obj) {
+      walk(obj[key]);
+    }
+  }
+  
+  walk(schema);
+  
+  if (fixed) {
+    fs.writeFileSync(schemaPath, JSON.stringify(schema, null, 2) + '\n');
+    return true;
+  }
+  
+  return false;
+}
+
+function findSchemas(dir) {
+  const schemas = [];
+  
+  function scan(currentDir) {
+    const entries = fs.readdirSync(currentDir, { withFileTypes: true });
+    
+    for (const entry of entries) {
+      const fullPath = path.join(currentDir, entry.name);
+      
+      if (entry.isDirectory()) {
+        scan(fullPath);
+      } else if (entry.name.endsWith('.schema.json')) {
+        schemas.push(fullPath);
+      }
+    }
+  }
+  
+  scan(dir);
+  return schemas;
+}
+
+console.log('🔧 Fixing schema format constraints...\n');
+
+const schemas = findSchemas(SPEC_DIR);
+let fixedCount = 0;
+
+for (const schemaPath of schemas) {
+  const relative = path.relative(process.cwd(), schemaPath);
+  
+  try {
+    if (fixSchema(schemaPath)) {
+      console.log(`✓ Fixed: ${relative}`);
+      fixedCount++;
+    }
+  } catch (err) {
+    console.error(`✗ Error in ${relative}: ${err.message}`);
+  }
+}
+
+console.log(`\n${fixedCount} schema(s) fixed`);

package/scripts/gen-types.ts

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+/**
+ * Generate TypeScript types from current version schema
+ * 
+ * Follows OpenAPI-first, DRY, and type-safe principles.
+ * Uses Zod for validation and shared utilities.
+ */
+
+import { join } from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { getCurrentVersion, getSchemaPath, getTypesOutputPath } from './lib/version.js';
+import { requireFile, writeFile } from './lib/file-ops.js';
+import { execCommand } from './lib/exec.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const ROOT = join(__dirname, '..');
+
+async function main() {
+  try {
+    // Get version with validation
+    const version = getCurrentVersion();
+    console.log(`📦 Current version: ${version}`);
+    
+    // Build paths
+    const schemaPath = join(ROOT, getSchemaPath(version));
+    const outputPath = join(ROOT, getTypesOutputPath(version));
+    
+    // Validate schema exists
+    requireFile(schemaPath, `Schema not found at ${schemaPath}`);
+    console.log(`📄 Schema: ${schemaPath}`);
+    
+    // Generate types
+    console.log('🔄 Generating TypeScript types...');
+    const output = execCommand(`npx json-schema-to-typescript ${schemaPath}`, {
+      encoding: 'utf8',
+    });
+    
+    // Write output
+    writeFile(outputPath, output);
+    console.log(`✅ Generated: ${outputPath}`);
+    
+  } catch (error) {
+    console.error('❌ Error:', error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+}
+
+main();
+

package/scripts/gen-zod.ts

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+/**
+ * Generate Zod schemas from current version schema
+ * 
+ * Follows OpenAPI-first, DRY, and type-safe principles.
+ * Uses Zod for validation and shared utilities.
+ */
+
+import { join } from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { getCurrentVersion, getSchemaPath, getZodOutputPath } from './lib/version.js';
+import { requireFile, writeFile } from './lib/file-ops.js';
+import { execCommand } from './lib/exec.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const ROOT = join(__dirname, '..');
+
+async function main() {
+  try {
+    // Get version with validation
+    const version = getCurrentVersion();
+    console.log(`📦 Current version: ${version}`);
+    
+    // Build paths
+    const schemaPath = join(ROOT, getSchemaPath(version));
+    const outputPath = join(ROOT, getZodOutputPath(version));
+    
+    // Validate schema exists
+    requireFile(schemaPath, `Schema not found at ${schemaPath}`);
+    console.log(`📄 Schema: ${schemaPath}`);
+    
+    // Generate Zod schemas
+    console.log('🔄 Generating Zod schemas...');
+    const output = execCommand(`npx json-schema-to-zod ${schemaPath}`, {
+      encoding: 'utf8',
+    });
+    
+    // Write output
+    writeFile(outputPath, output);
+    console.log(`✅ Generated: ${outputPath}`);
+    
+  } catch (error) {
+    console.error('❌ Error:', error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+}
+
+main();
+

package/scripts/generate-agents-catalog.ts

@@ -0,0 +1,77 @@
+#!/usr/bin/env tsx
+import { readdirSync, readFileSync, writeFileSync, statSync, mkdirSync } from 'fs';
+import { join, relative } from 'path';
+import yaml from 'js-yaml';
+
+const AGENTS_DIR = join(process.cwd(), '.gitlab/agents');
+const OUTPUT_FILE = join(process.cwd(), 'website/content/docs/agents/catalog.md');
+
+interface Agent {
+  id: string;
+  name: string;
+  role: string;
+  description?: string;
+  capabilities: Array<{ name: string; description: string }>;
+  path: string;
+}
+
+function findAgents(): Agent[] {
+  const agents: Agent[] = [];
+  const entries = readdirSync(AGENTS_DIR);
+  
+  for (const entry of entries) {
+    const manifestPath = join(AGENTS_DIR, entry, 'manifest.ossa.yaml');
+    try {
+      const content = readFileSync(manifestPath, 'utf-8');
+      const data = yaml.load(content) as any;
+      
+      if (data?.agent) {
+        agents.push({
+          id: data.agent.id,
+          name: data.agent.name,
+          role: data.agent.role,
+          description: data.agent.description,
+          capabilities: data.agent.capabilities || [],
+          path: relative(process.cwd(), manifestPath)
+        });
+      }
+    } catch (error) {
+      // Skip if no manifest
+    }
+  }
+  
+  return agents;
+}
+
+const agents = findAgents();
+
+let doc = `# GitLab Agents Catalog
+
+OSSA-compliant agents for GitLab CI/CD automation.
+
+**Total Agents**: ${agents.length}
+
+`;
+
+for (const agent of agents.sort((a, b) => a.name.localeCompare(b.name))) {
+  doc += `## ${agent.name}\n\n`;
+  doc += `**ID**: \`${agent.id}\`  \n`;
+  doc += `**Role**: \`${agent.role}\`\n\n`;
+  if (agent.description) doc += `${agent.description}\n\n`;
+  
+  if (agent.capabilities.length > 0) {
+    doc += `### Capabilities\n\n`;
+    for (const cap of agent.capabilities) {
+      doc += `- **${cap.name}**: ${cap.description}\n`;
+    }
+    doc += '\n';
+  }
+  
+  doc += `**Manifest**: [\`${agent.path}\`](https://github.com/blueflyio/openstandardagents/blob/main/${agent.path})\n\n`;
+  doc += `\`\`\`bash\n# Deploy agent\nkubectl apply -f ${agent.path}\n\`\`\`\n\n`;
+}
+
+mkdirSync(join(process.cwd(), 'website/content/docs/agents'), { recursive: true });
+writeFileSync(OUTPUT_FILE, doc);
+
+console.log(`✅ Generated agents catalog: ${agents.length} agents`);