claude-flow-novice 1.5.20 → 1.5.22

package/.claude-flow-novice/dist/src/providers/zai-provider.js

@@ -0,0 +1,268 @@
+/**
+ * Z.ai Provider Implementation (Tier 3)
+ * Minimal implementation for testing Z.ai API integration
+ */ import { BaseProvider } from './base-provider.js';
+import { LLMProviderError } from './types.js';
+export class ZaiProvider extends BaseProvider {
+    name = 'zai';
+    capabilities = {
+        supportedModels: [
+            'claude-3-5-sonnet-20241022'
+        ],
+        maxContextLength: {
+            'claude-3-5-sonnet-20241022': 200000
+        },
+        maxOutputTokens: {
+            'claude-3-5-sonnet-20241022': 8192
+        },
+        supportsStreaming: true,
+        supportsFunctionCalling: false,
+        supportsSystemMessages: true,
+        supportsVision: true,
+        supportsAudio: false,
+        supportsTools: false,
+        supportsFineTuning: false,
+        supportsEmbeddings: false,
+        supportsLogprobs: false,
+        supportsBatching: false,
+        pricing: {
+            'claude-3-5-sonnet-20241022': {
+                promptCostPer1k: 0.003,
+                completionCostPer1k: 0.015,
+                currency: 'USD'
+            }
+        }
+    };
+    apiKey;
+    baseURL = 'https://api.z.ai/v1';
+    async doInitialize() {
+        // Validate API key
+        if (!this.config.apiKey) {
+            throw new Error('Z.ai API key is required. Set Z_AI_API_KEY in .env');
+        }
+        this.apiKey = this.config.apiKey;
+        this.logger.info('Z.ai provider initialized', {
+            model: this.config.model,
+            baseURL: this.baseURL
+        });
+    }
+    async doComplete(request) {
+        const model = request.model || this.config.model;
+        // Build request payload
+        const payload = {
+            model,
+            messages: request.messages.filter((msg)=>msg.role !== 'function').map((msg)=>({
+                    role: msg.role,
+                    content: msg.content
+                })),
+            temperature: request.temperature ?? this.config.temperature,
+            max_tokens: request.maxTokens ?? this.config.maxTokens,
+            stream: false
+        };
+        // Call Z.ai API
+        const response = await this.callZaiAPI('/chat/completions', payload);
+        // Calculate cost
+        const pricing = this.capabilities.pricing[model];
+        const promptCost = response.usage.prompt_tokens / 1000 * pricing.promptCostPer1k;
+        const completionCost = response.usage.completion_tokens / 1000 * pricing.completionCostPer1k;
+        // Convert to unified response format
+        return {
+            id: response.id,
+            model,
+            provider: 'zai',
+            content: response.choices[0].message.content,
+            usage: {
+                promptTokens: response.usage.prompt_tokens,
+                completionTokens: response.usage.completion_tokens,
+                totalTokens: response.usage.total_tokens
+            },
+            cost: {
+                promptCost,
+                completionCost,
+                totalCost: promptCost + completionCost,
+                currency: 'USD'
+            },
+            finishReason: response.choices[0].finish_reason === 'stop' ? 'stop' : 'length'
+        };
+    }
+    async *doStreamComplete(request) {
+        const model = request.model || this.config.model;
+        // Build request payload
+        const payload = {
+            model,
+            messages: request.messages.filter((msg)=>msg.role !== 'function').map((msg)=>({
+                    role: msg.role,
+                    content: msg.content
+                })),
+            temperature: request.temperature ?? this.config.temperature,
+            max_tokens: request.maxTokens ?? this.config.maxTokens,
+            stream: true
+        };
+        // Call Z.ai streaming API
+        const response = await fetch(`${this.baseURL}/chat/completions`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${this.apiKey}`
+            },
+            body: JSON.stringify(payload)
+        });
+        if (!response.ok) {
+            throw new LLMProviderError(`Z.ai API error: ${response.status} ${response.statusText}`, 'API_ERROR', 'zai', undefined, response.status >= 500);
+        }
+        if (!response.body) {
+            throw new LLMProviderError('No response body from Z.ai API', 'NO_RESPONSE_BODY', 'zai');
+        }
+        // Process SSE stream
+        const reader = response.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        let totalTokens = 0;
+        try {
+            while(true){
+                const { done, value } = await reader.read();
+                if (done) break;
+                buffer += decoder.decode(value, {
+                    stream: true
+                });
+                const lines = buffer.split('\n');
+                buffer = lines.pop() || '';
+                for (const line of lines){
+                    if (!line.trim() || line.startsWith(':')) continue;
+                    if (line.startsWith('data: ')) {
+                        const data = line.slice(6);
+                        if (data === '[DONE]') continue;
+                        try {
+                            const event = JSON.parse(data);
+                            if (event.choices?.[0]?.delta?.content) {
+                                yield {
+                                    type: 'content',
+                                    delta: {
+                                        content: event.choices[0].delta.content
+                                    }
+                                };
+                            }
+                            if (event.usage) {
+                                totalTokens = event.usage.total_tokens;
+                            }
+                        } catch (parseError) {
+                            this.logger.warn('Failed to parse SSE event', {
+                                line,
+                                error: parseError
+                            });
+                        }
+                    }
+                }
+            }
+            // Emit final usage statistics
+            const pricing = this.capabilities.pricing[model];
+            const promptTokens = this.estimateTokens(JSON.stringify(request.messages));
+            const completionTokens = totalTokens - promptTokens;
+            const promptCost = promptTokens / 1000 * pricing.promptCostPer1k;
+            const completionCost = completionTokens / 1000 * pricing.completionCostPer1k;
+            yield {
+                type: 'done',
+                usage: {
+                    promptTokens,
+                    completionTokens,
+                    totalTokens
+                },
+                cost: {
+                    promptCost,
+                    completionCost,
+                    totalCost: promptCost + completionCost,
+                    currency: 'USD'
+                }
+            };
+        } finally{
+            reader.releaseLock();
+        }
+    }
+    async listModels() {
+        return this.capabilities.supportedModels;
+    }
+    async getModelInfo(model) {
+        return {
+            model,
+            name: 'Claude 3.5 Sonnet',
+            description: 'Claude 3.5 Sonnet via Z.ai',
+            contextLength: this.capabilities.maxContextLength[model] || 200000,
+            maxOutputTokens: this.capabilities.maxOutputTokens[model] || 8192,
+            supportedFeatures: [
+                'chat',
+                'completion',
+                'vision',
+                'streaming'
+            ],
+            pricing: this.capabilities.pricing[model]
+        };
+    }
+    async doHealthCheck() {
+        try {
+            // Minimal health check request
+            const response = await this.callZaiAPI('/chat/completions', {
+                model: this.config.model,
+                messages: [
+                    {
+                        role: 'user',
+                        content: 'Hi'
+                    }
+                ],
+                max_tokens: 1,
+                stream: false
+            });
+            return {
+                healthy: true,
+                timestamp: new Date(),
+                details: {
+                    model: response.model,
+                    status: 'operational'
+                }
+            };
+        } catch (error) {
+            return {
+                healthy: false,
+                error: error instanceof Error ? error.message : 'Unknown error',
+                timestamp: new Date()
+            };
+        }
+    }
+    /**
+   * Call Z.ai API with error handling
+   */ async callZaiAPI(endpoint, payload) {
+        const url = `${this.baseURL}${endpoint}`;
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${this.apiKey}`
+                },
+                body: JSON.stringify(payload)
+            });
+            if (!response.ok) {
+                const errorBody = await response.text();
+                let errorMessage = `Z.ai API error: ${response.status} ${response.statusText}`;
+                try {
+                    const errorJson = JSON.parse(errorBody);
+                    errorMessage = errorJson.error?.message || errorMessage;
+                } catch  {
+                // Use default error message if body is not JSON
+                }
+                throw new LLMProviderError(errorMessage, response.status === 429 ? 'RATE_LIMIT' : 'API_ERROR', 'zai', undefined, response.status >= 500);
+            }
+            return await response.json();
+        } catch (error) {
+            if (error instanceof LLMProviderError) {
+                throw error;
+            }
+            throw new LLMProviderError(error instanceof Error ? error.message : String(error), 'NETWORK_ERROR', 'zai', undefined, true);
+        }
+    }
+    destroy() {
+        super.destroy();
+        this.logger.info('Z.ai provider destroyed');
+    }
+}
+
+//# sourceMappingURL=zai-provider.js.map

package/.claude-flow-novice/dist/src/providers/zai-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/providers/zai-provider.ts"],"names":["BaseProvider","LLMProviderError","ZaiProvider","name","capabilities","supportedModels","maxContextLength","maxOutputTokens","supportsStreaming","supportsFunctionCalling","supportsSystemMessages","supportsVision","supportsAudio","supportsTools","supportsFineTuning","supportsEmbeddings","supportsLogprobs","supportsBatching","pricing","promptCostPer1k","completionCostPer1k","currency","apiKey","baseURL","doInitialize","config","Error","logger","info","model","doComplete","request","payload","messages","filter","msg","role","map","content","temperature","max_tokens","maxTokens","stream","response","callZaiAPI","promptCost","usage","prompt_tokens","completionCost","completion_tokens","id","provider","choices","message","promptTokens","completionTokens","totalTokens","total_tokens","cost","totalCost","finishReason","finish_reason","doStreamComplete","fetch","method","headers","Authorization","body","JSON","stringify","ok","status","statusText","undefined","reader","getReader","decoder","TextDecoder","buffer","done","value","read","decode","lines","split","pop","line","trim","startsWith","data","slice","event","parse","delta","type","parseError","warn","error","estimateTokens","releaseLock","listModels","getModelInfo","description","contextLength","supportedFeatures","doHealthCheck","healthy","timestamp","Date","details","endpoint","url","errorBody","text","errorMessage","errorJson","json","String","destroy"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-flow-novice",
-  "version": "1.5.20",
+  "version": "1.5.22",
   "description": "Standalone Claude Flow for beginners - AI agent orchestration made easy with enhanced TDD testing pipeline. Enhanced init command creates complete agent system, MCP configuration with 30 essential tools, and automated hooks with single-file testing, real-time coverage analysis, and advanced validation. Fully standalone with zero external dependencies, complete project setup in one command.",
   "mcpName": "io.github.ruvnet/claude-flow",
   "main": ".claude-flow-novice/dist/index.js",

package/src/cli/simple-commands/init/templates/CLAUDE.md

@@ -32,6 +32,31 @@
 - Refactoring or optimization work
 - ANY feature development (even "simple" ones)
 
+## 🚨 CRITICAL: Safe Test Execution
+
+**NEVER run tests inside agents** - causes memory leaks from orphaned processes.
+
+### Correct Pattern:
+```bash
+# 1. Run tests ONCE, save results
+npm test -- --run --reporter=json > test-results.json 2>&1
+
+# 2. Agents READ results file (no execution)
+cat test-results.json
+
+# 3. Kill orphaned processes after swarm
+pkill -f vitest; pkill -f "npm test"
+```
+
+### Forbidden:
+- ❌ `Task("agent", "run npm test", "type")` - spawns orphaned process
+- ❌ Multiple agents running tests concurrently - 3x memory usage
+- ❌ Long-running test commands without timeout cleanup
+
+### Memory Impact:
+- Each test run: 65MB+ heap
+- Concurrent runs: 65MB × agent_count
+- Orphaned processes persist after swarm completion
 ### Agent Requirements by Task Complexity
 
 | Task Size | Steps | Agent Count | Example Team Composition |

package/src/hooks/enhanced-hooks-cli.js

@@ -61,8 +61,9 @@ Enhanced Features:
     }
 
     // Build unified pipeline command with TDD mode enabled by default
-    // Use process.cwd() to find config/hooks in the actual project, not dist
-    const pipelinePath = join(process.cwd(), 'config/hooks/post-edit-pipeline.js');
+    // Use __dirname to find config/hooks in the installed package location
+    // Path: .claude-flow-novice/dist/src/hooks -> ../../../../config/hooks
+    const pipelinePath = join(__dirname, '../../../../config/hooks/post-edit-pipeline.js');
     const pipelineArgs = [file, '--tdd-mode'];
 
     // Pass through all relevant flags
@@ -81,18 +82,28 @@ Enhanced Features:
       // Structured output is default in unified pipeline
     }
 
-    // Execute unified pipeline
+    // Execute unified pipeline with timeout protection
     const proc = spawn('node', [pipelinePath, ...pipelineArgs], {
       stdio: 'inherit',
       cwd: process.cwd()
     });
 
+    // Set timeout to kill hanging processes (5 minutes max)
+    const timeout = setTimeout(() => {
+      console.error('❌ Pipeline timeout - killing process');
+      proc.kill('SIGKILL');
+      process.exit(1);
+    }, 300000); // 5 minutes
+
     proc.on('close', (code) => {
+      clearTimeout(timeout);
       process.exit(code || 0);
     });
 
     proc.on('error', (error) => {
+      clearTimeout(timeout);
       console.error(`❌ Failed to execute unified pipeline: ${error.message}`);
+      proc.kill('SIGKILL');
       process.exit(1);
     });
 
@@ -121,10 +132,17 @@ export async function enhancedPostEdit(file, memoryKey = null, options = {}) {
     let stdout = '';
     let stderr = '';
 
+    // Set timeout to kill hanging processes (5 minutes max)
+    const timeout = setTimeout(() => {
+      proc.kill('SIGKILL');
+      reject(new Error('Pipeline execution timeout after 5 minutes'));
+    }, 300000); // 5 minutes
+
     proc.stdout.on('data', (data) => stdout += data.toString());
     proc.stderr.on('data', (data) => stderr += data.toString());
 
     proc.on('close', (code) => {
+      clearTimeout(timeout);
       resolve({
         success: code === 0,
         file,
@@ -137,6 +155,8 @@ export async function enhancedPostEdit(file, memoryKey = null, options = {}) {
     });
 
     proc.on('error', (error) => {
+      clearTimeout(timeout);
+      proc.kill('SIGKILL');
       reject(error);
     });
   });