claude-flow-novice 2.2.3 → 2.2.5

package/scripts/test-zai-diagnostic.cjs

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+
+/**
+ * Z.ai API Diagnostic Test
+ * Tests multiple endpoint variations
+ */
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+
+// Load .env
+function loadEnv() {
+  const envPath = path.join(process.cwd(), '.env');
+  if (!fs.existsSync(envPath)) return false;
+
+  const envContent = fs.readFileSync(envPath, 'utf8');
+  envContent.split('\n').forEach(line => {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) return;
+
+    const match = trimmed.match(/^([^=]+)=(.*)$/);
+    if (match) {
+      const key = match[1].trim();
+      let value = match[2].trim();
+      if ((value.startsWith('"') && value.endsWith('"')) ||
+          (value.startsWith("'") && value.endsWith("'"))) {
+        value = value.slice(1, -1);
+      }
+      process.env[key] = value;
+    }
+  });
+  return true;
+}
+
+loadEnv();
+
+const API_KEY = process.env.ZAI_API_KEY || process.env.Z_AI_API_KEY;
+
+if (!API_KEY) {
+  console.error('❌ No API key found');
+  process.exit(1);
+}
+
+console.log('\n🔍 Z.ai API Diagnostic Test\n');
+console.log('='.repeat(80));
+console.log('\n✓ API Key:', API_KEY.substring(0, 15) + '...' + API_KEY.substring(API_KEY.length - 4));
+
+// Test different endpoints and models
+const tests = [
+  {
+    name: 'GLM-4.6 via /v1/chat/completions',
+    url: 'https://api.z.ai/v1/chat/completions',
+    model: 'glm-4.6'
+  },
+  {
+    name: 'GLM-4-Flash via /v1/chat/completions',
+    url: 'https://api.z.ai/v1/chat/completions',
+    model: 'glm-4-flash'
+  },
+  {
+    name: 'Claude via /v1/chat/completions',
+    url: 'https://api.z.ai/v1/chat/completions',
+    model: 'claude-3-5-sonnet-20241022'
+  },
+  {
+    name: 'Check /v1/models endpoint',
+    url: 'https://api.z.ai/v1/models',
+    method: 'GET'
+  }
+];
+
+function testEndpoint(test) {
+  return new Promise((resolve) => {
+    const url = new URL(test.url);
+
+    const options = {
+      hostname: url.hostname,
+      port: 443,
+      path: url.pathname,
+      method: test.method || 'POST',
+      headers: {
+        'Authorization': `Bearer ${API_KEY}`,
+        'Content-Type': 'application/json'
+      }
+    };
+
+    let data = null;
+    if (test.method !== 'GET') {
+      data = JSON.stringify({
+        model: test.model,
+        messages: [{ role: 'user', content: 'Hi' }],
+        max_tokens: 10
+      });
+    }
+
+    const req = https.request(options, (res) => {
+      let body = '';
+      res.on('data', chunk => body += chunk);
+      res.on('end', () => {
+        resolve({
+          status: res.statusCode,
+          body: body.substring(0, 500)
+        });
+      });
+    });
+
+    req.on('error', (error) => {
+      resolve({ status: 'ERROR', error: error.message });
+    });
+
+    req.setTimeout(15000, () => {
+      req.destroy();
+      resolve({ status: 'TIMEOUT' });
+    });
+
+    if (data) req.write(data);
+    req.end();
+  });
+}
+
+async function runDiagnostics() {
+  for (const test of tests) {
+    console.log(`\n${'─'.repeat(80)}`);
+    console.log(`\n📍 ${test.name}`);
+    console.log(`   URL: ${test.url}`);
+    if (test.model) console.log(`   Model: ${test.model}`);
+
+    const result = await testEndpoint(test);
+
+    if (result.status === 'ERROR') {
+      console.log(`   ❌ Error: ${result.error}`);
+    } else if (result.status === 'TIMEOUT') {
+      console.log(`   ⏱️  Timeout`);
+    } else if (result.status === 200 || result.status === 201) {
+      console.log(`   ✅ Success (${result.status})`);
+      console.log(`   Response: ${result.body.substring(0, 200)}...`);
+    } else {
+      console.log(`   ⚠️  Status: ${result.status}`);
+      console.log(`   Response: ${result.body.substring(0, 200)}`);
+    }
+  }
+
+  console.log('\n' + '='.repeat(80));
+  console.log('\n💡 Recommendations:');
+  console.log('   - Check Z.ai documentation for correct endpoint structure');
+  console.log('   - Verify API key permissions');
+  console.log('   - Confirm supported models list\n');
+}
+
+runDiagnostics().catch(console.error);

package/scripts/test-zai-final.cjs

@@ -0,0 +1,128 @@
+#!/usr/bin/env node
+
+/**
+ * Final Z.ai API Verification Test
+ */
+
+const https = require('https');
+const fs = require('fs');
+const path = require('path');
+
+// Load .env
+function loadEnv() {
+  const envPath = path.join(process.cwd(), '.env');
+  if (!fs.existsSync(envPath)) return false;
+
+  const envContent = fs.readFileSync(envPath, 'utf8');
+  envContent.split('\n').forEach(line => {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed.startsWith('#')) return;
+
+    const match = trimmed.match(/^([^=]+)=(.*)$/);
+    if (match) {
+      const key = match[1].trim();
+      let value = match[2].trim();
+      if ((value.startsWith('"') && value.endsWith('"')) ||
+          (value.startsWith("'") && value.endsWith("'"))) {
+        value = value.slice(1, -1);
+      }
+      process.env[key] = value;
+    }
+  });
+  return true;
+}
+
+loadEnv();
+
+const API_KEY = process.env.ZAI_API_KEY || process.env.ANTHROPIC_AUTH_TOKEN;
+
+function makeRequest(url, payload) {
+  return new Promise((resolve, reject) => {
+    const urlObj = new URL(url);
+
+    const options = {
+      hostname: urlObj.hostname,
+      port: 443,
+      path: urlObj.pathname,
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'x-api-key': API_KEY,
+        'anthropic-version': '2023-06-01'
+      }
+    };
+
+    const req = https.request(options, (res) => {
+      let body = '';
+      res.on('data', chunk => body += chunk);
+      res.on('end', () => {
+        try {
+          resolve({ status: res.statusCode, body: JSON.parse(body) });
+        } catch (e) {
+          resolve({ status: res.statusCode, body });
+        }
+      });
+    });
+
+    req.on('error', reject);
+    req.setTimeout(30000, () => {
+      req.destroy();
+      reject(new Error('Timeout'));
+    });
+
+    req.write(JSON.stringify(payload));
+    req.end();
+  });
+}
+
+async function test() {
+  console.log('\n🎯 Z.ai API Final Verification\n');
+  console.log('='.repeat(80) + '\n');
+
+  const tests = [
+    {
+      name: 'Test 1: Simple greeting (10K tokens)',
+      payload: {
+        model: 'claude-3-5-sonnet-20241022',
+        max_tokens: 10000,
+        messages: [{ role: 'user', content: 'Reply with exactly: "Hello from Z.ai GLM-4.6!"' }]
+      }
+    },
+    {
+      name: 'Test 2: Code generation (10K tokens)',
+      payload: {
+        model: 'claude-3-5-sonnet-20241022',
+        max_tokens: 10000,
+        messages: [{ role: 'user', content: 'Write a complete JavaScript class for managing a todo list with add, remove, and list methods. Include comments.' }]
+      }
+    }
+  ];
+
+  for (const test of tests) {
+    console.log(`📋 ${test.name}`);
+    console.log('-'.repeat(80));
+
+    try {
+      const result = await makeRequest('https://api.z.ai/api/anthropic/v1/messages', test.payload);
+
+      if (result.status === 200) {
+        console.log('✅ Success!');
+        console.log('Response:', result.body.content?.[0]?.text || result.body.content || 'Empty response');
+        console.log('Model:', result.body.model);
+        console.log('Tokens:', `${result.body.usage?.input_tokens || 0} in, ${result.body.usage?.output_tokens || 0} out`);
+      } else {
+        console.log('⚠️  Status:', result.status);
+        console.log('Body:', JSON.stringify(result.body, null, 2).substring(0, 200));
+      }
+    } catch (error) {
+      console.log('❌ Error:', error.message);
+    }
+
+    console.log('');
+  }
+
+  console.log('='.repeat(80));
+  console.log('\n✅ Z.ai API verification complete!\n');
+}
+
+test();

package/scripts/test-zai-with-env.cjs

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+
+/**
+ * Z.ai API Test with .env loading
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Load .env file
+function loadEnv() {
+  const envPath = path.join(process.cwd(), '.env');
+
+  if (!fs.existsSync(envPath)) {
+    console.error('❌ .env file not found in:', process.cwd());
+    return false;
+  }
+
+  try {
+    const envContent = fs.readFileSync(envPath, 'utf8');
+    const lines = envContent.split('\n');
+
+    for (const line of lines) {
+      const trimmed = line.trim();
+
+      // Skip comments and empty lines
+      if (!trimmed || trimmed.startsWith('#')) continue;
+
+      // Parse KEY=VALUE
+      const match = trimmed.match(/^([^=]+)=(.*)$/);
+      if (match) {
+        const key = match[1].trim();
+        let value = match[2].trim();
+
+        // Remove quotes if present
+        if ((value.startsWith('"') && value.endsWith('"')) ||
+            (value.startsWith("'") && value.endsWith("'"))) {
+          value = value.slice(1, -1);
+        }
+
+        process.env[key] = value;
+      }
+    }
+
+    return true;
+  } catch (error) {
+    console.error('❌ Error loading .env:', error.message);
+    return false;
+  }
+}
+
+// Load environment
+console.log('📁 Loading .env file...');
+if (!loadEnv()) {
+  process.exit(1);
+}
+
+// Check for Z_AI_API_KEY or ZAI_API_KEY
+if (process.env.Z_AI_API_KEY || process.env.ZAI_API_KEY) {
+  const key = process.env.Z_AI_API_KEY || process.env.ZAI_API_KEY;
+  const keyName = process.env.Z_AI_API_KEY ? 'Z_AI_API_KEY' : 'ZAI_API_KEY';
+  console.log(`✓ ${keyName} loaded from .env`);
+  console.log('  Key preview:', key.substring(0, 10) + '...\n');
+} else {
+  console.error('❌ Z_AI_API_KEY or ZAI_API_KEY not found in .env file');
+  console.log('\nSearching for Z.ai related keys in .env...');
+
+  const envPath = path.join(process.cwd(), '.env');
+  const envContent = fs.readFileSync(envPath, 'utf8');
+  const zaiKeys = envContent.split('\n').filter(line =>
+    line.toLowerCase().includes('z_ai') || line.toLowerCase().includes('zai')
+  );
+
+  if (zaiKeys.length > 0) {
+    console.log('Found:', zaiKeys.join('\n'));
+  } else {
+    console.log('No Z.ai related keys found');
+  }
+
+  process.exit(1);
+}
+
+// Now run the actual test
+console.log('🚀 Starting Z.ai API test...\n');
+require('./test-zai-api.cjs');

package/scripts/utils/README.md

@@ -0,0 +1,261 @@
+# Utility Scripts
+
+This directory contains general utility scripts for maintenance, fixes, and system operations.
+
+## Scripts
+
+### Code Fixing Utilities
+
+#### Import & Module Fixes
+- **`fix-import-paths.js`** - Fixes import path issues across the codebase
+- **`fix-imports.js`** - General import statement fixes and optimizations
+- **`fix-duplicate-imports.js`** - Removes duplicate import statements
+- **`fix-cliffy-imports.js`** - Fixes specific Cliffy CLI library import issues
+
+#### TypeScript Fixes
+- **`fix-ts-comprehensive.py`** - Comprehensive TypeScript error resolution
+- **`fix-ts-targeted-batch.js`** - Targeted TypeScript fixes in batches
+- **`fix-test-modules.js`** - Fixes test module imports and configurations
+
+#### General Code Fixes
+- **`fix-shebang.js`** - Fixes shebang lines in script files
+- **`fix-error-handling.cjs`** - Improves error handling patterns
+- **`fix-timezone-issue-246.js`** - Fixes specific timezone handling issue
+- **`simple-test-fixer.js`** - Simple test file fixes and corrections
+
+### Cleanup & Maintenance
+
+#### Build Cleanup
+- **`clean-build-artifacts.sh`** - Removes build artifacts and temporary files
+- **`cleanup-root.sh`** - Cleans up root directory of unnecessary files
+- **`remove-benchmark-conflicts.sh`** - Resolves benchmark file conflicts
+
+## Usage
+
+### Import Fixes
+```bash
+# Fix import paths
+node scripts/utils/fix-import-paths.js
+
+# Remove duplicate imports
+node scripts/utils/fix-duplicate-imports.js
+
+# Fix Cliffy imports specifically
+node scripts/utils/fix-cliffy-imports.js
+
+# General import optimization
+node scripts/utils/fix-imports.js
+```
+
+### TypeScript Fixes
+```bash
+# Comprehensive TypeScript fixes
+python scripts/utils/fix-ts-comprehensive.py
+
+# Targeted batch fixes
+node scripts/utils/fix-ts-targeted-batch.js
+
+# Test module fixes
+node scripts/utils/fix-test-modules.js
+```
+
+### System Maintenance
+```bash
+# Clean build artifacts
+bash scripts/utils/clean-build-artifacts.sh
+
+# Clean root directory
+bash scripts/utils/cleanup-root.sh
+
+# Remove benchmark conflicts
+bash scripts/utils/remove-benchmark-conflicts.sh
+```
+
+### Code Quality
+```bash
+# Fix shebang lines
+node scripts/utils/fix-shebang.js
+
+# Improve error handling
+node scripts/utils/fix-error-handling.cjs
+
+# Fix timezone issues
+node scripts/utils/fix-timezone-issue-246.js
+
+# Simple test fixes
+node scripts/utils/simple-test-fixer.js
+```
+
+## Script Categories
+
+### 1. Import & Module Management
+Scripts that handle import statements, module resolution, and dependency management.
+
+**Common Use Cases:**
+- Fixing broken import paths after file moves
+- Removing duplicate imports
+- Updating import statements for library changes
+- Resolving module resolution issues
+
+### 2. TypeScript Error Resolution
+Scripts specifically designed to fix TypeScript compilation errors.
+
+**Common Use Cases:**
+- Type annotation fixes
+- Interface compliance fixes
+- Generic type resolution
+- Module declaration fixes
+
+### 3. Test Infrastructure Fixes
+Scripts that maintain and fix test-related code.
+
+**Common Use Cases:**
+- Test import fixes
+- Test configuration updates
+- Mock and fixture repairs
+- Test runner compatibility
+
+### 4. Build System Maintenance
+Scripts that clean up and maintain the build system.
+
+**Common Use Cases:**
+- Artifact cleanup
+- Temporary file removal
+- Build cache management
+- Dependency cleanup
+
+### 5. Code Quality & Standards
+Scripts that enforce and fix code quality issues.
+
+**Common Use Cases:**
+- Shebang line standardization
+- Error handling improvements
+- Code style fixes
+- Lint error resolution
+
+## Integration with Build Process
+
+Many utility scripts are integrated into the build process:
+
+```json
+{
+  "scripts": {
+    "prebuild": "scripts/utils/clean-build-artifacts.sh",
+    "postbuild": "scripts/utils/fix-imports.js",
+    "fix:imports": "node scripts/utils/fix-import-paths.js",
+    "fix:duplicates": "node scripts/utils/fix-duplicate-imports.js",
+    "clean": "rm -rf dist .crdt-data .demo-crdt-data && scripts/utils/cleanup-root.sh"
+  }
+}
+```
+
+## Automation Features
+
+### Batch Processing
+Most scripts support batch processing for efficiency:
+```bash
+# Process multiple files
+node scripts/utils/fix-import-paths.js --batch src/**/*.ts
+
+# Dry run mode
+node scripts/utils/fix-ts-targeted-batch.js --dry-run
+
+# Verbose output
+python scripts/utils/fix-ts-comprehensive.py --verbose
+```
+
+### Safety Features
+- **Dry run mode** - Preview changes before applying
+- **Backup creation** - Automatic backups before modifications
+- **Rollback capability** - Ability to revert changes
+- **Validation checks** - Verify fixes don't break functionality
+
+### Integration with Version Control
+```bash
+# Check for uncommitted changes before running
+if git diff-index --quiet HEAD --; then
+    node scripts/utils/fix-import-paths.js
+else
+    echo "Uncommitted changes detected. Commit first."
+fi
+```
+
+## Best Practices
+
+### Before Running Utilities
+1. **Commit current changes** to version control
+2. **Run tests** to establish baseline
+3. **Create backup** if not automated
+4. **Use dry-run mode** to preview changes
+
+### After Running Utilities
+1. **Verify fixes** don't break functionality
+2. **Run tests** to ensure no regressions
+3. **Review changes** in version control
+4. **Commit fixes** with descriptive messages
+
+### Safe Usage Patterns
+```bash
+# Safe fix pattern
+git add -A && git commit -m "Pre-fix checkpoint"
+node scripts/utils/fix-import-paths.js --dry-run
+node scripts/utils/fix-import-paths.js
+npm test
+git add -A && git commit -m "Fix: Import path corrections"
+```
+
+## Troubleshooting
+
+### Script Execution Issues
+```bash
+# Check Node.js version
+node --version
+
+# Install dependencies
+npm install
+
+# Check file permissions
+chmod +x scripts/utils/*.sh
+```
+
+### Fix Script Failures
+```bash
+# Run with verbose logging
+node scripts/utils/fix-import-paths.js --verbose
+
+# Check for syntax errors
+node --check scripts/utils/fix-import-paths.js
+
+# Use alternative Python version
+python3 scripts/utils/fix-ts-comprehensive.py
+```
+
+### Recovery from Bad Fixes
+```bash
+# Revert to last commit
+git reset --hard HEAD
+
+# Revert specific files
+git checkout HEAD -- path/to/file.ts
+
+# Use backup files (if created)
+cp file.ts.backup file.ts
+```
+
+## Contributing New Utilities
+
+When adding new utility scripts:
+
+1. **Follow naming convention** - `fix-[issue-type]-[specific-name].js`
+2. **Include safety features** - dry-run, backup, validation
+3. **Add comprehensive logging** - progress, errors, results
+4. **Write documentation** - usage, examples, troubleshooting
+5. **Test thoroughly** - various file types, edge cases
+6. **Update this README** - add script description and usage
+
+## Related Directories
+
+- `../build/` - Build-specific utilities
+- `../test/` - Test-specific utilities
+- `../dev/` - Development utilities
+- `../legacy/` - Superseded utility scripts