@bluefly/openstandardagents 0.2.9 → 0.3.0

package/scripts/configure-gitlab-branch-protection.ts

@@ -1,95 +0,0 @@
-#!/usr/bin/env tsx
-/**
- * Configure GitLab Branch Protection Rules
- * Sets up protection for main and development branches via GitLab API
- */
-
-import { Gitlab } from '@gitbeaker/rest';
-
-const PROJECT_ID = 'blueflyio/openstandardagents';
-const TOKEN = process.env.GITLAB_TOKEN || process.env.SERVICE_ACCOUNT_OSSA_TOKEN || process.env.GITLAB_PUSH_TOKEN;
-
-if (!TOKEN) {
-  console.error('❌ Error: GITLAB_TOKEN or SERVICE_ACCOUNT_OSSA_TOKEN required');
-  process.exit(1);
-}
-
-const gitlab = new Gitlab({
-  host: 'https://gitlab.com',
-  token: TOKEN,
-});
-
-interface ProtectionRule {
-  name: string;
-  push_access_levels?: Array<{ access_level: number }>;
-  merge_access_levels?: Array<{ access_level: number }>;
-  allow_force_push?: boolean;
-  allowed_to_push?: Array<{ user_id?: number; group_id?: number }>;
-  allowed_to_merge?: Array<{ user_id?: number; group_id?: number }>;
-}
-
-async function protectBranch(branch: string, rules: ProtectionRule): Promise<void> {
-  try {
-    console.log(`\n🔒 Protecting branch: ${branch}`);
-    
-    // Check if branch is already protected
-    const existing = await gitlab.ProtectedBranches.all(PROJECT_ID);
-    const isProtected = existing.some((pb: any) => pb.name === branch);
-    
-    if (isProtected) {
-      console.log(`  ⚠️  ${branch} is already protected. Updating...`);
-      await gitlab.ProtectedBranches.unprotect(PROJECT_ID, branch);
-    }
-    
-    // Protect the branch
-    await gitlab.ProtectedBranches.protect(PROJECT_ID, branch, {
-      push_access_levels: [{ access_level: 0 }], // No one can push
-      merge_access_levels: [{ access_level: 40 }], // Maintainers can merge
-      allow_force_push: false,
-    });
-    
-    console.log(`  ✅ ${branch} protected successfully`);
-    console.log(`     - Push: Blocked (no direct pushes)`);
-    console.log(`     - Merge: Maintainers only (via MR)`);
-    console.log(`     - Force push: Disabled`);
-  } catch (error: any) {
-    console.error(`  ❌ Failed to protect ${branch}:`, error.message);
-    throw error;
-  }
-}
-
-async function main() {
-  console.log('🔒 Configuring GitLab Branch Protection Rules\n');
-  console.log(`Project: ${PROJECT_ID}`);
-  console.log(`Token: ${TOKEN.substring(0, 10)}...`);
-  
-  try {
-    // Protect main branch
-    await protectBranch('main', {
-      name: 'main',
-      push_access_levels: [{ access_level: 0 }], // No one
-      merge_access_levels: [{ access_level: 40 }], // Maintainers
-      allow_force_push: false,
-    });
-    
-    // Protect development branch
-    await protectBranch('development', {
-      name: 'development',
-      push_access_levels: [{ access_level: 0 }], // No one
-      merge_access_levels: [{ access_level: 40 }], // Maintainers
-      allow_force_push: false,
-    });
-    
-    console.log('\n✅ Branch protection configured successfully!');
-    console.log('\nProtected branches:');
-    console.log('  - main: No direct pushes, MR required');
-    console.log('  - development: No direct pushes, MR required');
-    console.log('\nView in GitLab:');
-    console.log(`  https://gitlab.com/${PROJECT_ID}/-/settings/repository#protected-branches`);
-  } catch (error: any) {
-    console.error('\n❌ Error configuring branch protection:', error.message);
-    process.exit(1);
-  }
-}
-
-main();

package/scripts/create-issue-helper.ts

@@ -1,238 +0,0 @@
-#!/usr/bin/env tsx
-
-/**
- * GitLab Issue Creation Helper (Zod Edition)
- * 
- * Creates GitLab issues via API with proper validation and error handling.
- * Uses Zod for runtime validation and type safety.
- * 
- * Usage:
- *   npx tsx scripts/create-issue-helper.ts <title> <milestone-id> <labels> [description-file]
- * 
- * Example:
- *   npx tsx scripts/create-issue-helper.ts "Enhance bin" 3 "enhancement,cli,bin" .gitlab/ISSUE-BIN-ENHANCEMENT.md
- */
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { z } from 'zod';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// ============================================================================
-// Zod Schemas
-// ============================================================================
-
-const ConfigSchema = z.object({
-  gitlabApiUrl: z.string().url(),
-  gitlabToken: z.string().min(1, 'GitLab token is required'),
-  projectId: z.string().min(1, 'Project ID is required'),
-  title: z.string().min(1, 'Title is required'),
-  milestoneId: z.number().int().positive('Milestone ID must be a positive integer'),
-  labels: z.array(z.string().min(1)).min(1, 'At least one label is required'),
-  description: z.string().optional(),
-});
-
-const GitLabIssueResponseSchema = z.object({
-  iid: z.number(),
-  web_url: z.string().url(),
-  title: z.string(),
-  state: z.string(),
-});
-
-const GitLabErrorResponseSchema = z.object({
-  message: z.string().optional(),
-  error: z.string().optional(),
-});
-
-type Config = z.infer<typeof ConfigSchema>;
-type GitLabIssueResponse = z.infer<typeof GitLabIssueResponseSchema>;
-type GitLabErrorResponse = z.infer<typeof GitLabErrorResponseSchema>;
-
-// ============================================================================
-// Configuration
-// ============================================================================
-
-function getConfig(): Config {
-  const args = process.argv.slice(2);
-  
-  if (args.length < 3) {
-    console.error('❌ Usage: tsx scripts/create-issue-helper.ts <title> <milestone-id> <labels> [description-file]');
-    console.error('   Example: tsx scripts/create-issue-helper.ts "Enhance bin" 3 "enhancement,cli,bin" .gitlab/ISSUE-BIN-ENHANCEMENT.md');
-    process.exit(1);
-  }
-
-  const [title, milestoneIdStr, labelsStr, descFile] = args;
-  
-  // Parse milestone ID
-  const milestoneId = parseInt(milestoneIdStr, 10);
-  if (isNaN(milestoneId) || milestoneId <= 0) {
-    console.error(`❌ Invalid milestone ID: ${milestoneIdStr}`);
-    process.exit(1);
-  }
-
-  // Parse labels
-  const labels = labelsStr.split(',').map(l => l.trim()).filter(l => l.length > 0);
-  if (labels.length === 0) {
-    console.error(`❌ No valid labels provided: ${labelsStr}`);
-    process.exit(1);
-  }
-
-  // Read description file if provided
-  let description: string | undefined;
-  if (descFile) {
-    const descPath = path.isAbsolute(descFile) ? descFile : path.join(process.cwd(), descFile);
-    if (!fs.existsSync(descPath)) {
-      console.error(`❌ Description file not found: ${descPath}`);
-      process.exit(1);
-    }
-    description = fs.readFileSync(descPath, 'utf-8');
-  }
-
-  // Get GitLab token (try multiple sources)
-  const gitlabToken = process.env.SERVICE_ACCOUNT_OSSA_TOKEN ||
-                      process.env.SERVICE_ACCOUNT_VERSION_MANAGER_TOKEN ||
-                      process.env.GITLAB_TOKEN ||
-                      process.env.GITLAB_PUSH_TOKEN ||
-                      '';
-
-  if (!gitlabToken) {
-    console.error('❌ No GitLab token found. Please set one of:');
-    console.error('   - SERVICE_ACCOUNT_OSSA_TOKEN');
-    console.error('   - SERVICE_ACCOUNT_VERSION_MANAGER_TOKEN');
-    console.error('   - GITLAB_TOKEN');
-    console.error('   - GITLAB_PUSH_TOKEN');
-    process.exit(1);
-  }
-
-  // Get project ID
-  const projectId = process.env.CI_PROJECT_ID || 
-                    process.env.GITLAB_PROJECT_ID ||
-                    'blueflyio/openstandardagents';
-
-  // Get API URL
-  const gitlabApiUrl = process.env.CI_API_V4_URL ||
-                       process.env.GITLAB_API_URL ||
-                       'https://gitlab.com/api/v4';
-
-  try {
-    return ConfigSchema.parse({
-      gitlabApiUrl,
-      gitlabToken,
-      projectId,
-      title,
-      milestoneId,
-      labels,
-      description,
-    });
-  } catch (error) {
-    if (error instanceof z.ZodError) {
-      console.error('❌ Configuration validation failed:');
-      error.issues.forEach((issue) => {
-        console.error(`   • ${issue.path.join('.')}: ${issue.message}`);
-      });
-    } else {
-      console.error('❌ Configuration error:', error instanceof Error ? error.message : String(error));
-    }
-    process.exit(1);
-  }
-}
-
-// ============================================================================
-// GitLab API
-// ============================================================================
-
-async function createIssue(config: Config): Promise<GitLabIssueResponse> {
-  const projectPath = encodeURIComponent(config.projectId);
-  const url = `${config.gitlabApiUrl}/projects/${projectPath}/issues`;
-
-  const payload = {
-    title: config.title,
-    description: config.description || '',
-    milestone_id: config.milestoneId,
-    labels: config.labels.join(','),
-  };
-
-  try {
-    const response = await fetch(url, {
-      method: 'POST',
-      headers: {
-        'PRIVATE-TOKEN': config.gitlabToken,
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify(payload),
-    });
-
-    const responseText = await response.text();
-    let responseData: unknown;
-
-    try {
-      responseData = JSON.parse(responseText);
-    } catch {
-      responseData = responseText;
-    }
-
-    if (!response.ok) {
-      // Try to parse as error response
-      const errorData = GitLabErrorResponseSchema.safeParse(responseData);
-      if (errorData.success) {
-        const error = errorData.data;
-        throw new Error(`GitLab API error: ${error.message || error.error || responseText}`);
-      }
-      throw new Error(`GitLab API error (HTTP ${response.status}): ${responseText}`);
-    }
-
-    // Validate response
-    const issue = GitLabIssueResponseSchema.parse(responseData);
-    return issue;
-  } catch (error) {
-    if (error instanceof z.ZodError) {
-      console.error('❌ Invalid response from GitLab API:');
-      error.issues.forEach((issue) => {
-        console.error(`   • ${issue.path.join('.')}: ${issue.message}`);
-      });
-      throw new Error('Failed to parse GitLab API response');
-    }
-    throw error;
-  }
-}
-
-// ============================================================================
-// Main
-// ============================================================================
-
-async function main(): Promise<void> {
-  console.log('🔧 GitLab Issue Creation Helper (Zod Edition)');
-  console.log('==============================================\n');
-
-  const config = getConfig();
-  
-  console.log(`📋 Configuration:`);
-  console.log(`   Project: ${config.projectId}`);
-  console.log(`   Title: ${config.title}`);
-  console.log(`   Milestone: #${config.milestoneId}`);
-  console.log(`   Labels: ${config.labels.join(', ')}`);
-  console.log(`   Description: ${config.description ? `${config.description.length} chars` : 'none'}`);
-  console.log('');
-
-  try {
-    const issue = await createIssue(config);
-    
-    console.log('✅ Issue created successfully!');
-    console.log(`   Issue: !${issue.iid}`);
-    console.log(`   URL: ${issue.web_url}`);
-    console.log(`   State: ${issue.state}`);
-  } catch (error) {
-    console.error('❌ Failed to create issue:', error instanceof Error ? error.message : String(error));
-    process.exit(1);
-  }
-}
-
-// Run
-main().catch((error) => {
-  console.error('❌ Fatal error:', error instanceof Error ? error.message : String(error));
-  process.exit(1);
-});
-

package/scripts/create-milestone-issue.ts

@@ -1,73 +0,0 @@
-#!/usr/bin/env tsx
-
-/**
- * Create GitLab Issue for Milestone
- * Quick script to create issues via GitLab API
- */
-
-import { readFileSync } from 'fs';
-
-const GITLAB_API_URL = process.env.CI_API_V4_URL || 'https://gitlab.com/api/v4';
-const GITLAB_TOKEN = process.env.SERVICE_ACCOUNT_OSSA_TOKEN || 
-                      process.env.GITLAB_TOKEN || 
-                      process.env.GITLAB_PUSH_TOKEN || '';
-const PROJECT_ID = process.env.CI_PROJECT_ID || 'blueflyio/openstandardagents';
-
-async function createIssue(
-  title: string,
-  description: string,
-  milestoneId: number,
-  labels: string[] = []
-) {
-  if (!GITLAB_TOKEN) {
-    console.error('❌ GITLAB_TOKEN or SERVICE_ACCOUNT_OSSA_TOKEN required');
-    process.exit(1);
-  }
-
-  const projectPath = encodeURIComponent(PROJECT_ID);
-  const url = `${GITLAB_API_URL}/projects/${projectPath}/issues`;
-
-  try {
-    const response = await fetch(url, {
-      method: 'POST',
-      headers: {
-        'PRIVATE-TOKEN': GITLAB_TOKEN,
-        'Content-Type': 'application/json',
-      },
-      body: JSON.stringify({
-        title,
-        description,
-        milestone_id: milestoneId,
-        labels: labels.join(','),
-      }),
-    });
-
-    if (!response.ok) {
-      const error = await response.text();
-      throw new Error(`Failed to create issue: ${error}`);
-    }
-
-    const issue = await response.json();
-    console.log(`✅ Issue created: !${issue.iid}`);
-    console.log(`   URL: ${issue.web_url}`);
-    return issue.iid;
-  } catch (error) {
-    console.error('❌ Error creating issue:', error);
-    process.exit(1);
-  }
-}
-
-// Main
-const args = process.argv.slice(2);
-if (args.length < 3) {
-  console.log('Usage: tsx scripts/create-milestone-issue.ts <title> <milestone-id> <labels> [description-file]');
-  console.log('Example: tsx scripts/create-milestone-issue.ts "Enhance bin" 3 "enhancement,cli"');
-  process.exit(1);
-}
-
-const [title, milestoneId, labelsStr, descFile] = args;
-const labels = labelsStr.split(',').map(l => l.trim());
-const description = descFile && readFileSync(descFile, 'utf-8') || '';
-
-createIssue(title, description, parseInt(milestoneId), labels);
-

package/scripts/enhanced-version-manager.ts

@@ -1,257 +0,0 @@
-#!/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/eslint-to-codequality.cjs

@@ -1,34 +0,0 @@
-#!/usr/bin/env node
-const fs = require('fs');
-const crypto = require('crypto');
-
-const eslintResults = JSON.parse(fs.readFileSync(process.argv[2] || 'eslint-report.json', 'utf8'));
-
-const codeQualityReport = [];
-
-eslintResults.forEach(file => {
-  file.messages.forEach(msg => {
-    const fingerprint = crypto
-      .createHash('md5')
-      .update(`${file.filePath}:${msg.line}:${msg.ruleId}`)
-      .digest('hex');
-
-    codeQualityReport.push({
-      description: msg.message,
-      check_name: msg.ruleId || 'eslint',
-      fingerprint,
-      severity: msg.severity === 2 ? 'major' : 'minor',
-      location: {
-        path: file.filePath.replace(process.cwd() + '/', ''),
-        lines: {
-          begin: msg.line
-        }
-      }
-    });
-  });
-});
-
-fs.writeFileSync(
-  process.argv[3] || 'gl-code-quality-report.json',
-  JSON.stringify(codeQualityReport, null, 2)
-);