claude-flow-novice 2.3.4 → 2.3.6

package/dist/scripts/validate-coordination-toggle-integration.cjs

@@ -1,501 +0,0 @@
-/**
- * Standalone validation script for Phase 11 Coordination Toggle Integration
- *
- * Validates:
- * 1. CoordinationToggle version detection
- * 2. V1CoordinatorAdapter interface compatibility
- * 3. ConfigTranslator config mapping
- * 4. Feature flags rollout logic
- * 5. CLI version flag parsing
- *
- * Exit codes:
- * - 0: All validations passed (≥90% consensus)
- * - 1: Validations failed (<90% consensus)
- */
-
-const assert = require('assert');
-
-// ===========================
-// Test Suite
-// ===========================
-
-const results = {
-  totalTests: 0,
-  passingTests: 0,
-  failingTests: 0,
-  tests: []
-};
-
-function test(name, fn) {
-  results.totalTests++;
-  try {
-    fn();
-    results.passingTests++;
-    results.tests.push({ name, status: 'PASS' });
-    console.log(`✅ ${name}`);
-  } catch (error) {
-    results.failingTests++;
-    results.tests.push({ name, status: 'FAIL', error: error.message });
-    console.error(`❌ ${name}`);
-    console.error(`   Error: ${error.message}`);
-  }
-}
-
-// ===========================
-// 1. CoordinationToggle Version Detection
-// ===========================
-
-console.log('\n📋 Testing CoordinationToggle Version Detection...\n');
-
-test('should default to v2 when no config.version or env var is set', () => {
-  delete process.env.COORDINATION_VERSION;
-
-  // Simulate detectVersion logic
-  const detectVersion = (config) => {
-    if (config.version) return config.version;
-    const envVersion = process.env.COORDINATION_VERSION?.toLowerCase();
-    if (envVersion === 'v1' || envVersion === 'v2') return envVersion;
-    return 'v2';
-  };
-
-  const version = detectVersion({ topology: 'mesh', maxAgents: 5 });
-  assert.strictEqual(version, 'v2');
-});
-
-test('should use explicit config.version when provided', () => {
-  delete process.env.COORDINATION_VERSION;
-
-  const detectVersion = (config) => {
-    if (config.version) return config.version;
-    const envVersion = process.env.COORDINATION_VERSION?.toLowerCase();
-    if (envVersion === 'v1' || envVersion === 'v2') return envVersion;
-    return 'v2';
-  };
-
-  const version = detectVersion({ version: 'v1', topology: 'mesh' });
-  assert.strictEqual(version, 'v1');
-});
-
-test('should use COORDINATION_VERSION env var when config.version is omitted', () => {
-  process.env.COORDINATION_VERSION = 'v1';
-
-  const detectVersion = (config) => {
-    if (config.version) return config.version;
-    const envVersion = process.env.COORDINATION_VERSION?.toLowerCase();
-    if (envVersion === 'v1' || envVersion === 'v2') return envVersion;
-    return 'v2';
-  };
-
-  const version = detectVersion({ topology: 'mesh' });
-  assert.strictEqual(version, 'v1');
-
-  delete process.env.COORDINATION_VERSION;
-});
-
-test('should prioritize explicit config.version over env var', () => {
-  process.env.COORDINATION_VERSION = 'v1';
-
-  const detectVersion = (config) => {
-    if (config.version) return config.version;
-    const envVersion = process.env.COORDINATION_VERSION?.toLowerCase();
-    if (envVersion === 'v1' || envVersion === 'v2') return envVersion;
-    return 'v2';
-  };
-
-  const version = detectVersion({ version: 'v2', topology: 'mesh' });
-  assert.strictEqual(version, 'v2');
-
-  delete process.env.COORDINATION_VERSION;
-});
-
-// ===========================
-// 2. V1CoordinatorAdapter Interface Compatibility
-// ===========================
-
-console.log('\n📋 Testing V1CoordinatorAdapter Interface...\n');
-
-test('should have ICoordinator interface methods', () => {
-  const requiredMethods = [
-    'spawnAgent',
-    'pauseAgent',
-    'resumeAgent',
-    'terminateAgent',
-    'getAgentState',
-    'getAgentSession',
-    'createCheckpoint',
-    'restoreCheckpoint',
-    'listCheckpoints',
-    'getMetrics',
-    'getActiveAgents',
-    'getPausedAgents',
-    'updateTokenUsage',
-    'initialize',
-    'cleanup',
-    'isReady'
-  ];
-
-  // Mock V1CoordinatorAdapter structure
-  class MockV1Adapter {
-    async spawnAgent() {}
-    async pauseAgent() {}
-    async resumeAgent() {}
-    async terminateAgent() {}
-    async getAgentState() {}
-    async getAgentSession() {}
-    async createCheckpoint() {}
-    async restoreCheckpoint() {}
-    async listCheckpoints() { return []; }
-    getMetrics() { return {}; }
-    getActiveAgents() { return []; }
-    getPausedAgents() { return []; }
-    async updateTokenUsage() {}
-    async initialize() {}
-    async cleanup() {}
-    isReady() { return true; }
-  }
-
-  const adapter = new MockV1Adapter();
-  requiredMethods.forEach(method => {
-    assert.ok(typeof adapter[method] === 'function', `Missing method: ${method}`);
-  });
-});
-
-test('should translate V1 metrics to V2 CoordinatorMetrics format', () => {
-  const v2MetricsKeys = [
-    'totalAgentsSpawned',
-    'activeAgents',
-    'pausedAgents',
-    'totalTerminations',
-    'totalCheckpoints',
-    'totalRestores',
-    'averageCheckpointTimeMs',
-    'averageRestoreTimeMs',
-    'p99RestoreTimeMs',
-    'tokensSaved',
-    'totalTokensUsed',
-    'uptimeMs'
-  ];
-
-  const mockMetrics = {
-    totalAgentsSpawned: 10,
-    activeAgents: 5,
-    pausedAgents: 0,
-    totalTerminations: 3,
-    totalCheckpoints: 0,
-    totalRestores: 0,
-    averageCheckpointTimeMs: 0,
-    averageRestoreTimeMs: 0,
-    p99RestoreTimeMs: 0,
-    tokensSaved: 0,
-    totalTokensUsed: 50000,
-    uptimeMs: 60000
-  };
-
-  v2MetricsKeys.forEach(key => {
-    assert.ok(key in mockMetrics, `Missing metrics key: ${key}`);
-  });
-});
-
-// ===========================
-// 3. ConfigTranslator Config Mapping
-// ===========================
-
-console.log('\n📋 Testing ConfigTranslator Config Mapping...\n');
-
-test('should translate unified config to V1 mesh config', () => {
-  const unified = {
-    topology: 'mesh',
-    maxAgents: 5,
-    strategy: 'balanced',
-    enableConsensus: true
-  };
-
-  // Simulate ConfigTranslator.toV1Config
-  const v1Config = {
-    topology: unified.topology,
-    maxAgents: unified.maxAgents,
-    strategy: unified.strategy,
-    mesh: {
-      maxAgents: unified.maxAgents,
-      maxConnections: Math.floor(unified.maxAgents / 3),
-      taskDistributionStrategy: 'capability-based'
-    },
-    consensus: unified.enableConsensus ? {
-      protocol: 'quorum',
-      timeout: 5000
-    } : undefined
-  };
-
-  assert.strictEqual(v1Config.topology, 'mesh');
-  assert.strictEqual(v1Config.maxAgents, 5);
-  assert.strictEqual(v1Config.mesh.maxConnections, 1);
-  assert.strictEqual(v1Config.consensus.protocol, 'quorum');
-});
-
-test('should translate unified config to V1 hierarchical config', () => {
-  const unified = {
-    topology: 'hierarchical',
-    maxAgents: 15,
-    strategy: 'adaptive',
-    enableConsensus: true
-  };
-
-  const v1Config = {
-    topology: unified.topology,
-    maxAgents: unified.maxAgents,
-    strategy: unified.strategy,
-    hierarchical: {
-      minWorkers: Math.min(8, unified.maxAgents),
-      maxWorkers: unified.maxAgents,
-      autoScale: true,
-      scalingThreshold: 0.8
-    },
-    consensus: unified.enableConsensus ? {
-      protocol: 'raft',
-      timeout: 5000
-    } : undefined
-  };
-
-  assert.strictEqual(v1Config.topology, 'hierarchical');
-  assert.strictEqual(v1Config.maxAgents, 15);
-  assert.strictEqual(v1Config.hierarchical.minWorkers, 8);
-  assert.strictEqual(v1Config.consensus.protocol, 'raft');
-});
-
-test('should translate unified config to V2 FactoryOptions', () => {
-  const unified = {
-    topology: 'mesh',
-    maxAgents: 5,
-    strategy: 'balanced',
-    tokenBudget: 50000,
-    apiKey: 'test-api-key'
-  };
-
-  const v2Config = {
-    mode: 'sdk',
-    maxConcurrentAgents: unified.maxAgents,
-    defaultTokenBudget: unified.tokenBudget,
-    apiKey: unified.apiKey,
-    enableDynamicAllocation: unified.strategy !== 'performance',
-    verbose: false
-  };
-
-  assert.strictEqual(v2Config.mode, 'sdk');
-  assert.strictEqual(v2Config.maxConcurrentAgents, 5);
-  assert.strictEqual(v2Config.defaultTokenBudget, 50000);
-  assert.strictEqual(v2Config.enableDynamicAllocation, true);
-});
-
-test('should disable dynamic allocation when strategy is "performance"', () => {
-  const unified = {
-    topology: 'mesh',
-    maxAgents: 5,
-    strategy: 'performance'
-  };
-
-  const v2Config = {
-    mode: 'sdk',
-    maxConcurrentAgents: unified.maxAgents,
-    enableDynamicAllocation: unified.strategy !== 'performance'
-  };
-
-  assert.strictEqual(v2Config.enableDynamicAllocation, false);
-});
-
-// ===========================
-// 4. Feature Flags Rollout Logic
-// ===========================
-
-console.log('\n📋 Testing Feature Flags Rollout Logic...\n');
-
-test('should return false for all users at 0% rollout', () => {
-  process.env.V2_ROLLOUT_PERCENT = '0';
-
-  const shouldUseV2 = () => {
-    const rollout = Math.max(0, Math.min(100, parseInt(process.env.V2_ROLLOUT_PERCENT || '100', 10)));
-    if (rollout === 0) return false;
-    if (rollout === 100) return true;
-    return Math.random() * 100 < rollout;
-  };
-
-  assert.strictEqual(shouldUseV2(), false);
-  delete process.env.V2_ROLLOUT_PERCENT;
-});
-
-test('should return true for all users at 100% rollout', () => {
-  process.env.V2_ROLLOUT_PERCENT = '100';
-
-  const shouldUseV2 = () => {
-    const rollout = Math.max(0, Math.min(100, parseInt(process.env.V2_ROLLOUT_PERCENT || '100', 10)));
-    if (rollout === 0) return false;
-    if (rollout === 100) return true;
-    return Math.random() * 100 < rollout;
-  };
-
-  assert.strictEqual(shouldUseV2(), true);
-  delete process.env.V2_ROLLOUT_PERCENT;
-});
-
-test('should produce consistent 40-60% split at 50% rollout (statistical)', () => {
-  process.env.V2_ROLLOUT_PERCENT = '50';
-
-  const hashUserId = (userId) => {
-    let hash = 0;
-    for (let i = 0; i < userId.length; i++) {
-      hash = ((hash << 5) - hash) + userId.charCodeAt(i);
-      hash |= 0;
-    }
-    return Math.abs(hash) % 100;
-  };
-
-  const shouldUseV2 = (userId) => {
-    const rollout = 50;
-    const hash = hashUserId(userId);
-    return hash < rollout;
-  };
-
-  const users = Array.from({ length: 1000 }, (_, i) => `user-${i}`);
-  const v2Users = users.filter(userId => shouldUseV2(userId));
-  const v2Percentage = (v2Users.length / users.length) * 100;
-
-  assert.ok(v2Percentage >= 40 && v2Percentage <= 60, `V2 percentage ${v2Percentage} outside 40-60% range`);
-
-  delete process.env.V2_ROLLOUT_PERCENT;
-});
-
-test('should prioritize COORDINATION_VERSION env var over rollout percentage', () => {
-  process.env.V2_ROLLOUT_PERCENT = '0';
-  process.env.COORDINATION_VERSION = 'v2';
-
-  const getCoordinationVersion = () => {
-    if (process.env.COORDINATION_VERSION) {
-      const version = process.env.COORDINATION_VERSION.toLowerCase();
-      if (version !== 'v1' && version !== 'v2') {
-        throw new Error('Invalid COORDINATION_VERSION');
-      }
-      return version;
-    }
-    const rollout = parseInt(process.env.V2_ROLLOUT_PERCENT || '100', 10);
-    return rollout === 100 || rollout > 0 ? 'v2' : 'v1';
-  };
-
-  assert.strictEqual(getCoordinationVersion(), 'v2');
-
-  delete process.env.V2_ROLLOUT_PERCENT;
-  delete process.env.COORDINATION_VERSION;
-});
-
-// ===========================
-// 5. CLI Version Flag Parsing
-// ===========================
-
-console.log('\n📋 Testing CLI Version Flag Parsing...\n');
-
-test('should default to v2 when no flag or env var is provided', () => {
-  delete process.env.COORDINATION_VERSION;
-  const cliFlag = undefined;
-
-  const coordinationVersion = (
-    cliFlag ||
-    process.env.COORDINATION_VERSION ||
-    'v2'
-  ).toLowerCase();
-
-  assert.strictEqual(coordinationVersion, 'v2');
-});
-
-test('should use CLI flag when provided', () => {
-  delete process.env.COORDINATION_VERSION;
-  const cliFlag = 'v1';
-
-  const coordinationVersion = (
-    cliFlag ||
-    process.env.COORDINATION_VERSION ||
-    'v2'
-  ).toLowerCase();
-
-  assert.strictEqual(coordinationVersion, 'v1');
-});
-
-test('should use env var when CLI flag is not provided', () => {
-  process.env.COORDINATION_VERSION = 'v1';
-  const cliFlag = undefined;
-
-  const coordinationVersion = (
-    cliFlag ||
-    process.env.COORDINATION_VERSION ||
-    'v2'
-  ).toLowerCase();
-
-  assert.strictEqual(coordinationVersion, 'v1');
-
-  delete process.env.COORDINATION_VERSION;
-});
-
-test('should prioritize CLI flag over env var', () => {
-  process.env.COORDINATION_VERSION = 'v1';
-  const cliFlag = 'v2';
-
-  const coordinationVersion = (
-    cliFlag ||
-    process.env.COORDINATION_VERSION ||
-    'v2'
-  ).toLowerCase();
-
-  assert.strictEqual(coordinationVersion, 'v2');
-
-  delete process.env.COORDINATION_VERSION;
-});
-
-test('should validate CLI flag as v1 or v2', () => {
-  const validateVersion = (version) => {
-    return version === 'v1' || version === 'v2';
-  };
-
-  assert.strictEqual(validateVersion('v1'), true);
-  assert.strictEqual(validateVersion('v2'), true);
-  assert.strictEqual(validateVersion('v3'), false);
-  assert.strictEqual(validateVersion(''), false);
-});
-
-// ===========================
-// Results Summary
-// ===========================
-
-console.log('\n' + '='.repeat(60));
-console.log('📊 VALIDATION SUMMARY');
-console.log('='.repeat(60));
-
-const passRate = (results.passingTests / results.totalTests) * 100;
-const consensusScore = passRate / 100;
-
-console.log(`\nTotal Tests: ${results.totalTests}`);
-console.log(`Passing Tests: ${results.passingTests}`);
-console.log(`Failing Tests: ${results.failingTests}`);
-console.log(`Pass Rate: ${passRate.toFixed(2)}%`);
-console.log(`Consensus Score: ${consensusScore.toFixed(2)}`);
-
-console.log('\n' + '='.repeat(60));
-
-if (consensusScore >= 0.90) {
-  console.log('✅ CONSENSUS APPROVED (≥0.90)');
-  console.log('Decision: APPROVE');
-  console.log('='.repeat(60));
-  console.log('\n✅ Phase 11 Coordination Toggle Integration VALIDATED');
-  process.exit(0);
-} else {
-  console.log('❌ CONSENSUS FAILED (<0.90)');
-  console.log('Decision: REJECT');
-  console.log('='.repeat(60));
-  console.log('\n❌ Phase 11 Coordination Toggle Integration NEEDS FIXES');
-
-  console.log('\nFailed Tests:');
-  results.tests
-    .filter(t => t.status === 'FAIL')
-    .forEach(t => {
-      console.log(`  - ${t.name}`);
-      console.log(`    Error: ${t.error}`);
-    });
-
-  process.exit(1);
-}