@weavelogic/knowledge-graph-agent 0.10.2 → 0.10.4

package/dist/cultivation/deep-analyzer.js

@@ -1,17 +1,8 @@
-import { execFileSync, spawn } from "child_process";
-import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { execFileSync, execSync } from "child_process";
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync } from "fs";
 import { resolve, join } from "path";
 import { createLogger } from "../utils/logger.js";
 const logger = createLogger("deep-analyzer");
-const VALID_AGENT_TYPES = /* @__PURE__ */ new Set([
-  "researcher",
-  "architect",
-  "analyst",
-  "coder",
-  "tester",
-  "reviewer",
-  "documenter"
-]);
 class DeepAnalyzer {
   projectRoot;
   docsPath;
@@ -20,7 +11,7 @@ class DeepAnalyzer {
   maxAgents;
   agentMode;
   agentTimeout;
-  claudeFlowCommand = null;
+  forceApiKey;
   constructor(options) {
     this.projectRoot = resolve(options.projectRoot);
     this.docsPath = options.docsPath || "docs";
@@ -28,51 +19,92 @@ class DeepAnalyzer {
     this.verbose = options.verbose || false;
     this.maxAgents = options.maxAgents || 5;
     this.agentMode = options.agentMode || "adaptive";
-    this.agentTimeout = options.agentTimeout || 6e4;
+    this.agentTimeout = options.agentTimeout || 12e4;
+    this.forceApiKey = options.forceApiKey || false;
   }
   /**
-   * Check if claude-flow is available and determine the best command to use
-   * Checks for direct command first (globally installed), then falls back to npx
+   * Check if running inside a Claude Code session
    */
-  async isAvailable() {
-    const command = await this.detectClaudeFlowCommand();
-    return command !== null;
+  isInsideClaudeCode() {
+    return process.env.CLAUDECODE === "1" || process.env.CLAUDE_CODE === "1";
   }
   /**
-   * Detect which claude-flow command to use
-   * Returns the command configuration or null if not available
+   * Check if Anthropic API key is available
    */
-  async detectClaudeFlowCommand() {
-    if (this.claudeFlowCommand !== null) {
-      return this.claudeFlowCommand;
-    }
+  hasApiKey() {
+    return !!process.env.ANTHROPIC_API_KEY;
+  }
+  /**
+   * Check if Claude CLI is available
+   */
+  isCliAvailable() {
     try {
-      execFileSync("claude-flow", ["--version"], {
+      execFileSync("claude", ["--version"], {
         stdio: "pipe",
         timeout: 5e3,
         windowsHide: true
       });
-      this.claudeFlowCommand = { cmd: "claude-flow", args: [] };
-      return this.claudeFlowCommand;
+      return true;
     } catch {
+      return false;
     }
-    try {
-      execFileSync("npx", ["claude-flow", "--version"], {
-        stdio: "pipe",
-        timeout: 3e4,
-        windowsHide: true
-      });
-      this.claudeFlowCommand = { cmd: "npx", args: ["claude-flow"] };
-      return this.claudeFlowCommand;
-    } catch {
-      return null;
+  }
+  /**
+   * Determine the best execution mode
+   */
+  detectExecutionMode() {
+    const insideClaudeCode = this.isInsideClaudeCode();
+    const hasApiKey = this.hasApiKey();
+    const cliAvailable = this.isCliAvailable();
+    if (this.forceApiKey) {
+      if (hasApiKey) {
+        return { mode: "api", reason: "Using API key (forced)" };
+      }
+      return { mode: "unavailable", reason: "ANTHROPIC_API_KEY not set (required when forceApiKey=true)" };
+    }
+    if (insideClaudeCode) {
+      if (hasApiKey) {
+        return { mode: "api", reason: "Using API key (inside Claude Code session)" };
+      }
+      return {
+        mode: "unavailable",
+        reason: "Cannot run deep analysis inside Claude Code session without ANTHROPIC_API_KEY. Either set ANTHROPIC_API_KEY environment variable, or run this command from a regular terminal."
+      };
+    }
+    if (cliAvailable) {
+      return { mode: "cli", reason: "Using Claude CLI" };
+    }
+    if (hasApiKey) {
+      return { mode: "api", reason: "Using API key (CLI not available)" };
     }
+    return {
+      mode: "unavailable",
+      reason: "Claude CLI not found. Install Claude Code (https://claude.ai/code) or set ANTHROPIC_API_KEY."
+    };
+  }
+  /**
+   * Check if analysis is available
+   */
+  async isAvailable() {
+    const mode = this.detectExecutionMode();
+    return mode.mode !== "unavailable";
+  }
+  /**
+   * Get availability status with reason
+   */
+  async getAvailabilityStatus() {
+    const mode = this.detectExecutionMode();
+    return {
+      available: mode.mode !== "unavailable",
+      reason: mode.reason
+    };
   }
   /**
    * Run deep analysis
    */
   async analyze() {
     const startTime = Date.now();
+    const executionMode = this.detectExecutionMode();
     const result = {
       success: false,
       agentsSpawned: 0,
@@ -80,13 +112,16 @@ class DeepAnalyzer {
       documentsCreated: 0,
       results: [],
       duration: 0,
-      errors: []
+      errors: [],
+      mode: executionMode.mode === "unavailable" ? "static" : executionMode.mode
     };
-    if (!await this.isAvailable()) {
-      result.errors.push("claude-flow is not available");
+    if (executionMode.mode === "unavailable") {
+      result.errors.push(executionMode.reason);
       result.duration = Date.now() - startTime;
+      logger.error("Deep analysis unavailable", new Error(executionMode.reason));
       return result;
     }
+    logger.info(`Starting deep analysis`, { mode: executionMode.mode, reason: executionMode.reason });
     if (!existsSync(this.outputDir)) {
       mkdirSync(this.outputDir, { recursive: true });
     }
@@ -116,18 +151,15 @@ class DeepAnalyzer {
         outputFile: "testing-analysis.md"
       }
     ];
-    logger.info("Starting deep analysis", { agents: agents.length, mode: this.agentMode });
-    if (this.agentMode === "parallel") {
-      result.results = await this.executeParallel(agents);
-    } else if (this.agentMode === "sequential") {
-      result.results = await this.executeSequential(agents);
-    } else {
-      result.results = await this.executeAdaptive(agents);
+    logger.info("Executing analysis agents", { agents: agents.length, mode: "sequential" });
+    for (const agent of agents) {
+      const agentResult = await this.executeAgent(agent, executionMode.mode);
+      result.results.push(agentResult);
     }
     result.agentsSpawned = result.results.length;
     result.insightsCount = result.results.reduce((sum, r) => sum + r.insights.length, 0);
     result.documentsCreated = result.results.reduce((sum, r) => sum + r.documents.length, 0);
-    result.success = result.results.every((r) => r.success);
+    result.success = result.results.some((r) => r.success);
     result.duration = Date.now() - startTime;
     for (const agentResult of result.results) {
       if (agentResult.error) {
@@ -142,48 +174,10 @@ class DeepAnalyzer {
     });
     return result;
   }
-  /**
-   * Execute agents in parallel
-   */
-  async executeParallel(agents) {
-    const promises = agents.map((agent) => this.executeAgent(agent));
-    return Promise.all(promises);
-  }
-  /**
-   * Execute agents sequentially
-   */
-  async executeSequential(agents) {
-    const results = [];
-    for (const agent of agents) {
-      results.push(await this.executeAgent(agent));
-    }
-    return results;
-  }
-  /**
-   * Execute agents adaptively (start with 2, scale based on success)
-   */
-  async executeAdaptive(agents) {
-    const results = [];
-    const firstBatch = agents.slice(0, 2);
-    const firstResults = await Promise.all(firstBatch.map((a) => this.executeAgent(a)));
-    results.push(...firstResults);
-    const successRate = firstResults.filter((r) => r.success).length / firstResults.length;
-    if (successRate >= 0.5 && agents.length > 2) {
-      const remaining = agents.slice(2);
-      const remainingResults = await Promise.all(remaining.map((a) => this.executeAgent(a)));
-      results.push(...remainingResults);
-    } else if (agents.length > 2) {
-      logger.warn("Low success rate, switching to sequential mode");
-      for (const agent of agents.slice(2)) {
-        results.push(await this.executeAgent(agent));
-      }
-    }
-    return results;
-  }
   /**
    * Execute a single agent
    */
-  async executeAgent(agent) {
+  async executeAgent(agent, mode) {
     const startTime = Date.now();
     const outputPath = join(this.outputDir, agent.outputFile);
     const result = {
@@ -195,9 +189,14 @@ class DeepAnalyzer {
       duration: 0
     };
     try {
-      logger.info(`Spawning agent: ${agent.name}`, { type: agent.type });
+      logger.info(`Executing agent: ${agent.name}`, { type: agent.type, mode });
       const prompt = this.buildPrompt(agent);
-      const output = await this.runClaudeFlowAgent(agent.type, prompt);
+      let output;
+      if (mode === "cli") {
+        output = await this.runWithCli(prompt);
+      } else {
+        output = await this.runWithApi(prompt);
+      }
       result.insights = this.extractInsights(output);
       writeFileSync(outputPath, this.formatOutput(agent, output));
       result.documents.push({ path: outputPath, title: agent.name });
@@ -213,76 +212,122 @@ class DeepAnalyzer {
     return result;
   }
   /**
-   * Build prompt for agent
+   * Build context-aware prompt for analysis
    */
   buildPrompt(agent) {
-    return `You are a ${agent.name} analyzing the project at ${this.projectRoot}.
-
-**OBJECTIVE**: ${agent.task}
+    const context = this.gatherProjectContext();
+    return `You are analyzing a codebase. Here is the project context:
 
-**COORDINATION PROTOCOL**:
-\`\`\`bash
-claude-flow hooks pre-task --description "${agent.task}"
-\`\`\`
+${context}
 
-**YOUR TASKS**:
-1. Analyze the codebase at ${this.projectRoot}
-2. Identify key patterns and conventions
-3. Document your findings with specific examples
-4. Provide actionable recommendations
-5. Generate comprehensive markdown documentation
+Task: ${agent.task}
 
-**OUTPUT REQUIREMENTS**:
-- Use clear markdown formatting
-- Include code examples from the project
-- Organize findings by category
-- Prioritize actionable insights
+Provide your findings in markdown format with:
+1. Key observations (prefix with "Observation:")
+2. Specific recommendations (prefix with "Recommendation:")
+3. Any potential issues found (prefix with "Finding:")
 
-After completing:
-\`\`\`bash
-claude-flow hooks post-task --task-id "${agent.type}-analysis"
-\`\`\`
-`;
+Be specific and actionable in your analysis.`;
   }
   /**
-   * Run claude-flow agent
+   * Gather project context for analysis
    */
-  async runClaudeFlowAgent(type, prompt) {
-    if (!VALID_AGENT_TYPES.has(type)) {
-      throw new Error(`Invalid agent type: ${type}. Valid types: ${[...VALID_AGENT_TYPES].join(", ")}`);
+  gatherProjectContext() {
+    const lines = [];
+    const packageJsonPath = join(this.projectRoot, "package.json");
+    if (existsSync(packageJsonPath)) {
+      try {
+        const pkg = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+        lines.push(`Project: ${pkg.name || "Unknown"} v${pkg.version || "0.0.0"}`);
+        lines.push(`Description: ${pkg.description || "No description"}`);
+        if (pkg.dependencies) {
+          const deps = Object.keys(pkg.dependencies).slice(0, 10);
+          lines.push(`Key dependencies: ${deps.join(", ")}`);
+        }
+      } catch {
+      }
     }
-    const sanitizedPrompt = prompt.replace(/[`$\\]/g, "");
-    const commandConfig = await this.detectClaudeFlowCommand();
-    if (!commandConfig) {
-      throw new Error("claude-flow is not available");
+    try {
+      const entries = readdirSync(this.projectRoot, { withFileTypes: true });
+      const dirs = entries.filter((e) => e.isDirectory() && !e.name.startsWith(".") && e.name !== "node_modules").map((e) => e.name).slice(0, 10);
+      if (dirs.length > 0) {
+        lines.push(`Project structure: ${dirs.join(", ")}`);
+      }
+    } catch {
     }
-    return new Promise((resolve2, reject) => {
-      const args = [...commandConfig.args, "agent", "execute", type, sanitizedPrompt, "--json"];
-      const proc = spawn(commandConfig.cmd, args, {
+    const configFiles = [
+      "tsconfig.json",
+      "vite.config.ts",
+      "vitest.config.ts",
+      ".eslintrc.js",
+      "Dockerfile"
+    ];
+    const foundConfigs = configFiles.filter((f) => existsSync(join(this.projectRoot, f)));
+    if (foundConfigs.length > 0) {
+      lines.push(`Config files: ${foundConfigs.join(", ")}`);
+    }
+    return lines.join("\n");
+  }
+  /**
+   * Run analysis using Claude CLI
+   */
+  async runWithCli(prompt) {
+    const sanitizedPrompt = prompt.replace(/"/g, '\\"').replace(/[`$]/g, "");
+    try {
+      const result = execSync(`claude -p "${sanitizedPrompt}"`, {
         cwd: this.projectRoot,
-        shell: false,
-        // Security: Disable shell to prevent command injection
-        timeout: this.agentTimeout
-      });
-      let stdout = "";
-      let stderr = "";
-      proc.stdout?.on("data", (data) => {
-        stdout += data.toString();
-      });
-      proc.stderr?.on("data", (data) => {
-        stderr += data.toString();
+        encoding: "utf8",
+        timeout: this.agentTimeout,
+        maxBuffer: 10 * 1024 * 1024
+        // 10MB buffer
       });
-      proc.on("close", (code) => {
-        if (code === 0) {
-          resolve2(stdout);
-        } else {
-          reject(new Error(stderr || `Agent exited with code ${code}`));
+      return result;
+    } catch (error) {
+      if (error instanceof Error) {
+        const execError = error;
+        if (execError.killed) {
+          if (execError.stdout && execError.stdout.length > 100) {
+            return execError.stdout;
+          }
+          throw new Error(`Claude CLI timed out after ${this.agentTimeout / 1e3}s`);
         }
+        throw new Error(execError.stderr || error.message);
+      }
+      throw error;
+    }
+  }
+  /**
+   * Run analysis using Anthropic API directly
+   */
+  async runWithApi(prompt) {
+    const apiKey = process.env.ANTHROPIC_API_KEY;
+    if (!apiKey) {
+      throw new Error("ANTHROPIC_API_KEY not set");
+    }
+    try {
+      const { default: Anthropic } = await import("@anthropic-ai/sdk");
+      const client = new Anthropic({ apiKey });
+      const response = await client.messages.create({
+        model: "claude-sonnet-4-20250514",
+        max_tokens: 4096,
+        messages: [
+          {
+            role: "user",
+            content: prompt
+          }
+        ]
       });
-      proc.on("error", (error) => {
-        reject(error);
-      });
-    });
+      const textBlock = response.content.find((block) => block.type === "text");
+      if (textBlock && textBlock.type === "text") {
+        return textBlock.text;
+      }
+      throw new Error("No text content in API response");
+    } catch (error) {
+      if (error instanceof Error) {
+        throw new Error(`API call failed: ${error.message}`);
+      }
+      throw error;
+    }
   }
   /**
    * Extract insights from agent output
@@ -290,7 +335,7 @@ claude-flow hooks post-task --task-id "${agent.type}-analysis"
   extractInsights(output) {
     const insights = [];
     const patterns = [
-      /[-*]\s*(?:insight|finding|observation|recommendation):\s*(.+)/gi,
+      /[-*]?\s*(?:insight|finding|observation|recommendation):\s*(.+)/gi,
       /##\s*(?:insight|finding|observation|recommendation):\s*(.+)/gi,
       /(?:key\s+)?(?:insight|finding|observation|recommendation):\s*(.+)/gi
     ];
@@ -319,7 +364,7 @@ created: ${timestamp}
 
 # ${agent.name} Analysis
 
-> Generated by DeepAnalyzer using claude-flow
+> Generated by DeepAnalyzer
 
 ## Overview
 

package/dist/cultivation/deep-analyzer.js.map

@@ -1 +1 @@
-{"version":3,"file":"deep-analyzer.js","sources":["../../src/cultivation/deep-analyzer.ts"],"sourcesContent":["/**\n * DeepAnalyzer - Claude-Flow Integration for Deep Codebase Analysis\n *\n * Uses claude-flow agents for comprehensive codebase analysis:\n * - Pattern detection and architectural insights\n * - Documentation gap analysis\n * - Standards compliance checking\n *\n * @module cultivation/deep-analyzer\n */\n\nimport { execFileSync, spawn } from 'child_process';\nimport { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';\nimport { join, resolve } from 'path';\nimport { createLogger } from '../utils/index.js';\n\nconst logger = createLogger('deep-analyzer');\n\n/**\n * Valid agent types for security validation\n */\nconst VALID_AGENT_TYPES = new Set([\n  'researcher',\n  'architect',\n  'analyst',\n  'coder',\n  'tester',\n  'reviewer',\n  'documenter',\n]);\n\n/**\n * Deep analyzer options\n */\nexport interface DeepAnalyzerOptions {\n  /** Project root directory */\n  projectRoot: string;\n  /** Documentation path (relative to project root) */\n  docsPath?: string;\n  /** Output directory for analysis results */\n  outputDir?: string;\n  /** Enable verbose logging */\n  verbose?: boolean;\n  /** Maximum agents to spawn */\n  maxAgents?: number;\n  /** Agent execution mode */\n  agentMode?: 'sequential' | 'parallel' | 'adaptive';\n  /** Timeout for each agent (ms) */\n  agentTimeout?: number;\n}\n\n/**\n * Analysis result from an agent\n */\nexport interface AgentResult {\n  name: string;\n  type: string;\n  success: boolean;\n  insights: string[];\n  documents: Array<{ path: string; title: string }>;\n  duration: number;\n  error?: string;\n}\n\n/**\n * Deep analysis result\n */\nexport interface DeepAnalysisResult {\n  success: boolean;\n  agentsSpawned: number;\n  insightsCount: number;\n  documentsCreated: number;\n  results: AgentResult[];\n  duration: number;\n  errors: string[];\n}\n\n/**\n * Agent configuration\n */\ninterface AgentConfig {\n  name: string;\n  type: 'researcher' | 'analyst' | 'coder' | 'tester' | 'reviewer';\n  task: string;\n  outputFile: string;\n}\n\n/**\n * DeepAnalyzer - Uses claude-flow for deep codebase analysis\n *\n * @example\n * ```typescript\n * const analyzer = new DeepAnalyzer({\n *   projectRoot: '/my/project',\n *   docsPath: 'docs',\n * });\n *\n * const result = await analyzer.analyze();\n * console.log(`Generated ${result.insightsCount} insights`);\n * ```\n */\nexport class DeepAnalyzer {\n  private projectRoot: string;\n  private docsPath: string;\n  private outputDir: string;\n  private verbose: boolean;\n  private maxAgents: number;\n  private agentMode: 'sequential' | 'parallel' | 'adaptive';\n  private agentTimeout: number;\n  private claudeFlowCommand: { cmd: string; args: string[] } | null = null;\n\n  constructor(options: DeepAnalyzerOptions) {\n    this.projectRoot = resolve(options.projectRoot);\n    this.docsPath = options.docsPath || 'docs';\n    this.outputDir = options.outputDir || join(this.projectRoot, this.docsPath, 'analysis');\n    this.verbose = options.verbose || false;\n    this.maxAgents = options.maxAgents || 5;\n    this.agentMode = options.agentMode || 'adaptive';\n    // Default timeout of 60 seconds (configurable via agentTimeout option)\n    this.agentTimeout = options.agentTimeout || 60000;\n  }\n\n  /**\n   * Check if claude-flow is available and determine the best command to use\n   * Checks for direct command first (globally installed), then falls back to npx\n   */\n  async isAvailable(): Promise<boolean> {\n    const command = await this.detectClaudeFlowCommand();\n    return command !== null;\n  }\n\n  /**\n   * Detect which claude-flow command to use\n   * Returns the command configuration or null if not available\n   */\n  private async detectClaudeFlowCommand(): Promise<{ cmd: string; args: string[] } | null> {\n    // Return cached result if available\n    if (this.claudeFlowCommand !== null) {\n      return this.claudeFlowCommand;\n    }\n\n    // First try direct command (globally installed claude-flow)\n    try {\n      // SECURITY: execFileSync does not spawn a shell by default, preventing shell injection\n      execFileSync('claude-flow', ['--version'], {\n        stdio: 'pipe',\n        timeout: 5000,\n        windowsHide: true,\n      });\n      this.claudeFlowCommand = { cmd: 'claude-flow', args: [] };\n      return this.claudeFlowCommand;\n    } catch {\n      // Direct command not available, try npx\n    }\n\n    // Fall back to npx\n    try {\n      execFileSync('npx', ['claude-flow', '--version'], {\n        stdio: 'pipe',\n        timeout: 30000,\n        windowsHide: true,\n      });\n      this.claudeFlowCommand = { cmd: 'npx', args: ['claude-flow'] };\n      return this.claudeFlowCommand;\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Run deep analysis\n   */\n  async analyze(): Promise<DeepAnalysisResult> {\n    const startTime = Date.now();\n\n    const result: DeepAnalysisResult = {\n      success: false,\n      agentsSpawned: 0,\n      insightsCount: 0,\n      documentsCreated: 0,\n      results: [],\n      duration: 0,\n      errors: [],\n    };\n\n    // Check availability\n    if (!(await this.isAvailable())) {\n      result.errors.push('claude-flow is not available');\n      result.duration = Date.now() - startTime;\n      return result;\n    }\n\n    // Ensure output directory exists\n    if (!existsSync(this.outputDir)) {\n      mkdirSync(this.outputDir, { recursive: true });\n    }\n\n    // Define agents\n    const agents: AgentConfig[] = [\n      {\n        name: 'Pattern Researcher',\n        type: 'researcher',\n        task: 'Analyze codebase architecture, patterns, and design decisions',\n        outputFile: 'architecture-patterns.md',\n      },\n      {\n        name: 'Code Analyst',\n        type: 'analyst',\n        task: 'Identify code quality issues, complexity hotspots, and improvement opportunities',\n        outputFile: 'code-analysis.md',\n      },\n      {\n        name: 'Implementation Reviewer',\n        type: 'coder',\n        task: 'Review implementation patterns, naming conventions, and code style',\n        outputFile: 'implementation-review.md',\n      },\n      {\n        name: 'Test Analyzer',\n        type: 'tester',\n        task: 'Analyze test coverage, testing patterns, and testing gaps',\n        outputFile: 'testing-analysis.md',\n      },\n    ];\n\n    logger.info('Starting deep analysis', { agents: agents.length, mode: this.agentMode });\n\n    // Execute agents based on mode\n    if (this.agentMode === 'parallel') {\n      result.results = await this.executeParallel(agents);\n    } else if (this.agentMode === 'sequential') {\n      result.results = await this.executeSequential(agents);\n    } else {\n      // Adaptive: start with 2, scale based on success\n      result.results = await this.executeAdaptive(agents);\n    }\n\n    // Calculate totals\n    result.agentsSpawned = result.results.length;\n    result.insightsCount = result.results.reduce((sum, r) => sum + r.insights.length, 0);\n    result.documentsCreated = result.results.reduce((sum, r) => sum + r.documents.length, 0);\n    result.success = result.results.every(r => r.success);\n    result.duration = Date.now() - startTime;\n\n    // Collect errors\n    for (const agentResult of result.results) {\n      if (agentResult.error) {\n        result.errors.push(`${agentResult.name}: ${agentResult.error}`);\n      }\n    }\n\n    logger.info('Deep analysis complete', {\n      success: result.success,\n      insights: result.insightsCount,\n      documents: result.documentsCreated,\n      duration: result.duration,\n    });\n\n    return result;\n  }\n\n  /**\n   * Execute agents in parallel\n   */\n  private async executeParallel(agents: AgentConfig[]): Promise<AgentResult[]> {\n    const promises = agents.map(agent => this.executeAgent(agent));\n    return Promise.all(promises);\n  }\n\n  /**\n   * Execute agents sequentially\n   */\n  private async executeSequential(agents: AgentConfig[]): Promise<AgentResult[]> {\n    const results: AgentResult[] = [];\n    for (const agent of agents) {\n      results.push(await this.executeAgent(agent));\n    }\n    return results;\n  }\n\n  /**\n   * Execute agents adaptively (start with 2, scale based on success)\n   */\n  private async executeAdaptive(agents: AgentConfig[]): Promise<AgentResult[]> {\n    const results: AgentResult[] = [];\n\n    // First batch: 2 agents\n    const firstBatch = agents.slice(0, 2);\n    const firstResults = await Promise.all(firstBatch.map(a => this.executeAgent(a)));\n    results.push(...firstResults);\n\n    // Check success rate\n    const successRate = firstResults.filter(r => r.success).length / firstResults.length;\n\n    if (successRate >= 0.5 && agents.length > 2) {\n      // Continue with remaining agents in parallel\n      const remaining = agents.slice(2);\n      const remainingResults = await Promise.all(remaining.map(a => this.executeAgent(a)));\n      results.push(...remainingResults);\n    } else if (agents.length > 2) {\n      // Fall back to sequential\n      logger.warn('Low success rate, switching to sequential mode');\n      for (const agent of agents.slice(2)) {\n        results.push(await this.executeAgent(agent));\n      }\n    }\n\n    return results;\n  }\n\n  /**\n   * Execute a single agent\n   */\n  private async executeAgent(agent: AgentConfig): Promise<AgentResult> {\n    const startTime = Date.now();\n    const outputPath = join(this.outputDir, agent.outputFile);\n\n    const result: AgentResult = {\n      name: agent.name,\n      type: agent.type,\n      success: false,\n      insights: [],\n      documents: [],\n      duration: 0,\n    };\n\n    try {\n      logger.info(`Spawning agent: ${agent.name}`, { type: agent.type });\n\n      const prompt = this.buildPrompt(agent);\n\n      // Execute claude-flow agent\n      const output = await this.runClaudeFlowAgent(agent.type, prompt);\n\n      // Parse output for insights\n      result.insights = this.extractInsights(output);\n\n      // Write output to file\n      writeFileSync(outputPath, this.formatOutput(agent, output));\n      result.documents.push({ path: outputPath, title: agent.name });\n\n      result.success = true;\n\n      if (this.verbose) {\n        logger.debug(`Agent completed: ${agent.name}`, { insights: result.insights.length });\n      }\n    } catch (error) {\n      result.error = error instanceof Error ? error.message : String(error);\n      logger.error(`Agent failed: ${agent.name}`, error instanceof Error ? error : new Error(String(error)));\n    }\n\n    result.duration = Date.now() - startTime;\n    return result;\n  }\n\n  /**\n   * Build prompt for agent\n   */\n  private buildPrompt(agent: AgentConfig): string {\n    return `You are a ${agent.name} analyzing the project at ${this.projectRoot}.\n\n**OBJECTIVE**: ${agent.task}\n\n**COORDINATION PROTOCOL**:\n\\`\\`\\`bash\nclaude-flow hooks pre-task --description \"${agent.task}\"\n\\`\\`\\`\n\n**YOUR TASKS**:\n1. Analyze the codebase at ${this.projectRoot}\n2. Identify key patterns and conventions\n3. Document your findings with specific examples\n4. Provide actionable recommendations\n5. Generate comprehensive markdown documentation\n\n**OUTPUT REQUIREMENTS**:\n- Use clear markdown formatting\n- Include code examples from the project\n- Organize findings by category\n- Prioritize actionable insights\n\nAfter completing:\n\\`\\`\\`bash\nclaude-flow hooks post-task --task-id \"${agent.type}-analysis\"\n\\`\\`\\`\n`;\n  }\n\n  /**\n   * Run claude-flow agent\n   */\n  private async runClaudeFlowAgent(type: string, prompt: string): Promise<string> {\n    // Security: Validate agent type against allowlist to prevent command injection\n    if (!VALID_AGENT_TYPES.has(type)) {\n      throw new Error(`Invalid agent type: ${type}. Valid types: ${[...VALID_AGENT_TYPES].join(', ')}`);\n    }\n\n    // Security: Sanitize prompt to prevent injection via shell metacharacters\n    const sanitizedPrompt = prompt.replace(/[`$\\\\]/g, '');\n\n    // Get the detected command configuration\n    const commandConfig = await this.detectClaudeFlowCommand();\n    if (!commandConfig) {\n      throw new Error('claude-flow is not available');\n    }\n\n    return new Promise((resolve, reject) => {\n      // Build args based on detected command\n      const args = [...commandConfig.args, 'agent', 'execute', type, sanitizedPrompt, '--json'];\n\n      const proc = spawn(commandConfig.cmd, args, {\n        cwd: this.projectRoot,\n        shell: false, // Security: Disable shell to prevent command injection\n        timeout: this.agentTimeout,\n      });\n\n      let stdout = '';\n      let stderr = '';\n\n      proc.stdout?.on('data', (data) => {\n        stdout += data.toString();\n      });\n\n      proc.stderr?.on('data', (data) => {\n        stderr += data.toString();\n      });\n\n      proc.on('close', (code) => {\n        if (code === 0) {\n          resolve(stdout);\n        } else {\n          reject(new Error(stderr || `Agent exited with code ${code}`));\n        }\n      });\n\n      proc.on('error', (error) => {\n        reject(error);\n      });\n    });\n  }\n\n  /**\n   * Extract insights from agent output\n   */\n  private extractInsights(output: string): string[] {\n    const insights: string[] = [];\n\n    // Look for patterns like \"- Insight:\" or \"## Finding:\"\n    const patterns = [\n      /[-*]\\s*(?:insight|finding|observation|recommendation):\\s*(.+)/gi,\n      /##\\s*(?:insight|finding|observation|recommendation):\\s*(.+)/gi,\n      /(?:key\\s+)?(?:insight|finding|observation|recommendation):\\s*(.+)/gi,\n    ];\n\n    for (const pattern of patterns) {\n      const matches = output.matchAll(pattern);\n      for (const match of matches) {\n        if (match[1]) {\n          insights.push(match[1].trim());\n        }\n      }\n    }\n\n    // Deduplicate\n    return [...new Set(insights)];\n  }\n\n  /**\n   * Format output for documentation\n   */\n  private formatOutput(agent: AgentConfig, output: string): string {\n    const timestamp = new Date().toISOString();\n\n    return `---\ntitle: \"${agent.name} Analysis\"\ntype: analysis\ngenerator: deep-analyzer\nagent: ${agent.type}\ncreated: ${timestamp}\n---\n\n# ${agent.name} Analysis\n\n> Generated by DeepAnalyzer using claude-flow\n\n## Overview\n\n${agent.task}\n\n## Analysis\n\n${output}\n\n---\n\n*Generated on ${new Date().toLocaleString()}*\n`;\n  }\n}\n\n/**\n * Create a deep analyzer instance\n */\nexport function createDeepAnalyzer(options: DeepAnalyzerOptions): DeepAnalyzer {\n  return new DeepAnalyzer(options);\n}\n\n/**\n * Run deep analysis on a project\n */\nexport async function analyzeDeep(\n  projectRoot: string,\n  docsPath?: string\n): Promise<DeepAnalysisResult> {\n  const analyzer = new DeepAnalyzer({ projectRoot, docsPath });\n  return analyzer.analyze();\n}\n"],"names":["resolve"],"mappings":"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"}
+{"version":3,"file":"deep-analyzer.js","sources":["../../src/cultivation/deep-analyzer.ts"],"sourcesContent":["/**\n * DeepAnalyzer - Deep Codebase Analysis\n *\n * Provides comprehensive codebase analysis using:\n * - Claude CLI (`claude -p`) when running outside Claude Code\n * - Direct Anthropic API when ANTHROPIC_API_KEY is available\n * - Clear error messaging when neither option is available\n *\n * @module cultivation/deep-analyzer\n */\n\nimport { execFileSync, execSync } from 'child_process';\nimport { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync } from 'fs';\nimport { join, resolve, relative } from 'path';\nimport { createLogger } from '../utils/index.js';\n\nconst logger = createLogger('deep-analyzer');\n\n/**\n * Valid agent types for analysis\n */\nconst VALID_AGENT_TYPES = new Set([\n  'researcher',\n  'architect',\n  'analyst',\n  'coder',\n  'tester',\n  'reviewer',\n  'documenter',\n]);\n\n/**\n * Deep analyzer options\n */\nexport interface DeepAnalyzerOptions {\n  /** Project root directory */\n  projectRoot: string;\n  /** Documentation path (relative to project root) */\n  docsPath?: string;\n  /** Output directory for analysis results */\n  outputDir?: string;\n  /** Enable verbose logging */\n  verbose?: boolean;\n  /** Maximum agents to spawn */\n  maxAgents?: number;\n  /** Agent execution mode */\n  agentMode?: 'sequential' | 'parallel' | 'adaptive';\n  /** Timeout for each agent (ms) */\n  agentTimeout?: number;\n  /** Force use of API key even if CLI is available */\n  forceApiKey?: boolean;\n}\n\n/**\n * Analysis result from an agent\n */\nexport interface AgentResult {\n  name: string;\n  type: string;\n  success: boolean;\n  insights: string[];\n  documents: Array<{ path: string; title: string }>;\n  duration: number;\n  error?: string;\n}\n\n/**\n * Deep analysis result\n */\nexport interface DeepAnalysisResult {\n  success: boolean;\n  agentsSpawned: number;\n  insightsCount: number;\n  documentsCreated: number;\n  results: AgentResult[];\n  duration: number;\n  errors: string[];\n  mode: 'cli' | 'api' | 'static';\n}\n\n/**\n * Agent configuration\n */\ninterface AgentConfig {\n  name: string;\n  type: 'researcher' | 'analyst' | 'coder' | 'tester' | 'reviewer';\n  task: string;\n  outputFile: string;\n}\n\n/**\n * Execution mode detection result\n */\ninterface ExecutionMode {\n  mode: 'cli' | 'api' | 'unavailable';\n  reason: string;\n}\n\n/**\n * DeepAnalyzer - Deep codebase analysis with multiple execution modes\n *\n * @example\n * ```typescript\n * const analyzer = new DeepAnalyzer({\n *   projectRoot: '/my/project',\n *   docsPath: 'docs',\n * });\n *\n * const result = await analyzer.analyze();\n * console.log(`Generated ${result.insightsCount} insights`);\n * ```\n */\nexport class DeepAnalyzer {\n  private projectRoot: string;\n  private docsPath: string;\n  private outputDir: string;\n  private verbose: boolean;\n  private maxAgents: number;\n  private agentMode: 'sequential' | 'parallel' | 'adaptive';\n  private agentTimeout: number;\n  private forceApiKey: boolean;\n\n  constructor(options: DeepAnalyzerOptions) {\n    this.projectRoot = resolve(options.projectRoot);\n    this.docsPath = options.docsPath || 'docs';\n    this.outputDir = options.outputDir || join(this.projectRoot, this.docsPath, 'analysis');\n    this.verbose = options.verbose || false;\n    this.maxAgents = options.maxAgents || 5;\n    this.agentMode = options.agentMode || 'adaptive';\n    // Default timeout of 2 minutes (120 seconds)\n    this.agentTimeout = options.agentTimeout || 120000;\n    this.forceApiKey = options.forceApiKey || false;\n  }\n\n  /**\n   * Check if running inside a Claude Code session\n   */\n  private isInsideClaudeCode(): boolean {\n    return process.env.CLAUDECODE === '1' || process.env.CLAUDE_CODE === '1';\n  }\n\n  /**\n   * Check if Anthropic API key is available\n   */\n  private hasApiKey(): boolean {\n    return !!process.env.ANTHROPIC_API_KEY;\n  }\n\n  /**\n   * Check if Claude CLI is available\n   */\n  private isCliAvailable(): boolean {\n    try {\n      execFileSync('claude', ['--version'], {\n        stdio: 'pipe',\n        timeout: 5000,\n        windowsHide: true,\n      });\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  /**\n   * Determine the best execution mode\n   */\n  private detectExecutionMode(): ExecutionMode {\n    const insideClaudeCode = this.isInsideClaudeCode();\n    const hasApiKey = this.hasApiKey();\n    const cliAvailable = this.isCliAvailable();\n\n    // If forced to use API key\n    if (this.forceApiKey) {\n      if (hasApiKey) {\n        return { mode: 'api', reason: 'Using API key (forced)' };\n      }\n      return { mode: 'unavailable', reason: 'ANTHROPIC_API_KEY not set (required when forceApiKey=true)' };\n    }\n\n    // Inside Claude Code session - CLI doesn't work due to resource contention\n    if (insideClaudeCode) {\n      if (hasApiKey) {\n        return { mode: 'api', reason: 'Using API key (inside Claude Code session)' };\n      }\n      return {\n        mode: 'unavailable',\n        reason: 'Cannot run deep analysis inside Claude Code session without ANTHROPIC_API_KEY. ' +\n                'Either set ANTHROPIC_API_KEY environment variable, or run this command from a regular terminal.',\n      };\n    }\n\n    // Outside Claude Code - prefer CLI for OAuth session support\n    if (cliAvailable) {\n      return { mode: 'cli', reason: 'Using Claude CLI' };\n    }\n\n    // CLI not available, try API key\n    if (hasApiKey) {\n      return { mode: 'api', reason: 'Using API key (CLI not available)' };\n    }\n\n    return {\n      mode: 'unavailable',\n      reason: 'Claude CLI not found. Install Claude Code (https://claude.ai/code) or set ANTHROPIC_API_KEY.',\n    };\n  }\n\n  /**\n   * Check if analysis is available\n   */\n  async isAvailable(): Promise<boolean> {\n    const mode = this.detectExecutionMode();\n    return mode.mode !== 'unavailable';\n  }\n\n  /**\n   * Get availability status with reason\n   */\n  async getAvailabilityStatus(): Promise<{ available: boolean; reason: string }> {\n    const mode = this.detectExecutionMode();\n    return {\n      available: mode.mode !== 'unavailable',\n      reason: mode.reason,\n    };\n  }\n\n  /**\n   * Run deep analysis\n   */\n  async analyze(): Promise<DeepAnalysisResult> {\n    const startTime = Date.now();\n    const executionMode = this.detectExecutionMode();\n\n    const result: DeepAnalysisResult = {\n      success: false,\n      agentsSpawned: 0,\n      insightsCount: 0,\n      documentsCreated: 0,\n      results: [],\n      duration: 0,\n      errors: [],\n      mode: executionMode.mode === 'unavailable' ? 'static' : executionMode.mode,\n    };\n\n    // Check availability\n    if (executionMode.mode === 'unavailable') {\n      result.errors.push(executionMode.reason);\n      result.duration = Date.now() - startTime;\n      logger.error('Deep analysis unavailable', new Error(executionMode.reason));\n      return result;\n    }\n\n    logger.info(`Starting deep analysis`, { mode: executionMode.mode, reason: executionMode.reason });\n\n    // Ensure output directory exists\n    if (!existsSync(this.outputDir)) {\n      mkdirSync(this.outputDir, { recursive: true });\n    }\n\n    // Define agents\n    const agents: AgentConfig[] = [\n      {\n        name: 'Pattern Researcher',\n        type: 'researcher',\n        task: 'Analyze codebase architecture, patterns, and design decisions',\n        outputFile: 'architecture-patterns.md',\n      },\n      {\n        name: 'Code Analyst',\n        type: 'analyst',\n        task: 'Identify code quality issues, complexity hotspots, and improvement opportunities',\n        outputFile: 'code-analysis.md',\n      },\n      {\n        name: 'Implementation Reviewer',\n        type: 'coder',\n        task: 'Review implementation patterns, naming conventions, and code style',\n        outputFile: 'implementation-review.md',\n      },\n      {\n        name: 'Test Analyzer',\n        type: 'tester',\n        task: 'Analyze test coverage, testing patterns, and testing gaps',\n        outputFile: 'testing-analysis.md',\n      },\n    ];\n\n    logger.info('Executing analysis agents', { agents: agents.length, mode: 'sequential' });\n\n    // Execute agents sequentially\n    for (const agent of agents) {\n      const agentResult = await this.executeAgent(agent, executionMode.mode as 'cli' | 'api');\n      result.results.push(agentResult);\n    }\n\n    // Calculate totals\n    result.agentsSpawned = result.results.length;\n    result.insightsCount = result.results.reduce((sum, r) => sum + r.insights.length, 0);\n    result.documentsCreated = result.results.reduce((sum, r) => sum + r.documents.length, 0);\n    result.success = result.results.some(r => r.success); // Success if at least one agent succeeded\n    result.duration = Date.now() - startTime;\n\n    // Collect errors\n    for (const agentResult of result.results) {\n      if (agentResult.error) {\n        result.errors.push(`${agentResult.name}: ${agentResult.error}`);\n      }\n    }\n\n    logger.info('Deep analysis complete', {\n      success: result.success,\n      insights: result.insightsCount,\n      documents: result.documentsCreated,\n      duration: result.duration,\n    });\n\n    return result;\n  }\n\n  /**\n   * Execute a single agent\n   */\n  private async executeAgent(agent: AgentConfig, mode: 'cli' | 'api'): Promise<AgentResult> {\n    const startTime = Date.now();\n    const outputPath = join(this.outputDir, agent.outputFile);\n\n    const result: AgentResult = {\n      name: agent.name,\n      type: agent.type,\n      success: false,\n      insights: [],\n      documents: [],\n      duration: 0,\n    };\n\n    try {\n      logger.info(`Executing agent: ${agent.name}`, { type: agent.type, mode });\n\n      const prompt = this.buildPrompt(agent);\n      let output: string;\n\n      if (mode === 'cli') {\n        output = await this.runWithCli(prompt);\n      } else {\n        output = await this.runWithApi(prompt);\n      }\n\n      // Parse output for insights\n      result.insights = this.extractInsights(output);\n\n      // Write output to file\n      writeFileSync(outputPath, this.formatOutput(agent, output));\n      result.documents.push({ path: outputPath, title: agent.name });\n\n      result.success = true;\n\n      if (this.verbose) {\n        logger.debug(`Agent completed: ${agent.name}`, { insights: result.insights.length });\n      }\n    } catch (error) {\n      result.error = error instanceof Error ? error.message : String(error);\n      logger.error(`Agent failed: ${agent.name}`, error instanceof Error ? error : new Error(String(error)));\n    }\n\n    result.duration = Date.now() - startTime;\n    return result;\n  }\n\n  /**\n   * Build context-aware prompt for analysis\n   */\n  private buildPrompt(agent: AgentConfig): string {\n    // Gather project context\n    const context = this.gatherProjectContext();\n\n    return `You are analyzing a codebase. Here is the project context:\n\n${context}\n\nTask: ${agent.task}\n\nProvide your findings in markdown format with:\n1. Key observations (prefix with \"Observation:\")\n2. Specific recommendations (prefix with \"Recommendation:\")\n3. Any potential issues found (prefix with \"Finding:\")\n\nBe specific and actionable in your analysis.`;\n  }\n\n  /**\n   * Gather project context for analysis\n   */\n  private gatherProjectContext(): string {\n    const lines: string[] = [];\n\n    // Check for package.json\n    const packageJsonPath = join(this.projectRoot, 'package.json');\n    if (existsSync(packageJsonPath)) {\n      try {\n        const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));\n        lines.push(`Project: ${pkg.name || 'Unknown'} v${pkg.version || '0.0.0'}`);\n        lines.push(`Description: ${pkg.description || 'No description'}`);\n\n        if (pkg.dependencies) {\n          const deps = Object.keys(pkg.dependencies).slice(0, 10);\n          lines.push(`Key dependencies: ${deps.join(', ')}`);\n        }\n      } catch {\n        // Ignore parse errors\n      }\n    }\n\n    // List top-level directories\n    try {\n      const entries = readdirSync(this.projectRoot, { withFileTypes: true });\n      const dirs = entries\n        .filter(e => e.isDirectory() && !e.name.startsWith('.') && e.name !== 'node_modules')\n        .map(e => e.name)\n        .slice(0, 10);\n\n      if (dirs.length > 0) {\n        lines.push(`Project structure: ${dirs.join(', ')}`);\n      }\n    } catch {\n      // Ignore errors\n    }\n\n    // Check for common config files\n    const configFiles = [\n      'tsconfig.json',\n      'vite.config.ts',\n      'vitest.config.ts',\n      '.eslintrc.js',\n      'Dockerfile',\n    ];\n\n    const foundConfigs = configFiles.filter(f => existsSync(join(this.projectRoot, f)));\n    if (foundConfigs.length > 0) {\n      lines.push(`Config files: ${foundConfigs.join(', ')}`);\n    }\n\n    return lines.join('\\n');\n  }\n\n  /**\n   * Run analysis using Claude CLI\n   */\n  private async runWithCli(prompt: string): Promise<string> {\n    // Sanitize prompt - escape double quotes and remove dangerous chars\n    const sanitizedPrompt = prompt\n      .replace(/\"/g, '\\\\\"')\n      .replace(/[`$]/g, '');\n\n    try {\n      const result = execSync(`claude -p \"${sanitizedPrompt}\"`, {\n        cwd: this.projectRoot,\n        encoding: 'utf8',\n        timeout: this.agentTimeout,\n        maxBuffer: 10 * 1024 * 1024, // 10MB buffer\n      });\n      return result;\n    } catch (error) {\n      if (error instanceof Error) {\n        const execError = error as { stderr?: string; stdout?: string; killed?: boolean };\n        if (execError.killed) {\n          // Timeout - return partial output if available\n          if (execError.stdout && execError.stdout.length > 100) {\n            return execError.stdout;\n          }\n          throw new Error(`Claude CLI timed out after ${this.agentTimeout / 1000}s`);\n        }\n        throw new Error(execError.stderr || error.message);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Run analysis using Anthropic API directly\n   */\n  private async runWithApi(prompt: string): Promise<string> {\n    const apiKey = process.env.ANTHROPIC_API_KEY;\n    if (!apiKey) {\n      throw new Error('ANTHROPIC_API_KEY not set');\n    }\n\n    try {\n      // Dynamic import to avoid bundling issues\n      const { default: Anthropic } = await import('@anthropic-ai/sdk');\n\n      const client = new Anthropic({ apiKey });\n\n      const response = await client.messages.create({\n        model: 'claude-sonnet-4-20250514',\n        max_tokens: 4096,\n        messages: [\n          {\n            role: 'user',\n            content: prompt,\n          },\n        ],\n      });\n\n      // Extract text from response\n      const textBlock = response.content.find(block => block.type === 'text');\n      if (textBlock && textBlock.type === 'text') {\n        return textBlock.text;\n      }\n\n      throw new Error('No text content in API response');\n    } catch (error) {\n      if (error instanceof Error) {\n        throw new Error(`API call failed: ${error.message}`);\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Extract insights from agent output\n   */\n  private extractInsights(output: string): string[] {\n    const insights: string[] = [];\n\n    // Look for patterns like \"- Insight:\", \"Observation:\", \"Finding:\", \"Recommendation:\"\n    const patterns = [\n      /[-*]?\\s*(?:insight|finding|observation|recommendation):\\s*(.+)/gi,\n      /##\\s*(?:insight|finding|observation|recommendation):\\s*(.+)/gi,\n      /(?:key\\s+)?(?:insight|finding|observation|recommendation):\\s*(.+)/gi,\n    ];\n\n    for (const pattern of patterns) {\n      const matches = output.matchAll(pattern);\n      for (const match of matches) {\n        if (match[1]) {\n          insights.push(match[1].trim());\n        }\n      }\n    }\n\n    // Deduplicate\n    return [...new Set(insights)];\n  }\n\n  /**\n   * Format output for documentation\n   */\n  private formatOutput(agent: AgentConfig, output: string): string {\n    const timestamp = new Date().toISOString();\n\n    return `---\ntitle: \"${agent.name} Analysis\"\ntype: analysis\ngenerator: deep-analyzer\nagent: ${agent.type}\ncreated: ${timestamp}\n---\n\n# ${agent.name} Analysis\n\n> Generated by DeepAnalyzer\n\n## Overview\n\n${agent.task}\n\n## Analysis\n\n${output}\n\n---\n\n*Generated on ${new Date().toLocaleString()}*\n`;\n  }\n}\n\n/**\n * Create a deep analyzer instance\n */\nexport function createDeepAnalyzer(options: DeepAnalyzerOptions): DeepAnalyzer {\n  return new DeepAnalyzer(options);\n}\n\n/**\n * Run deep analysis on a project\n */\nexport async function analyzeDeep(\n  projectRoot: string,\n  docsPath?: string\n): Promise<DeepAnalysisResult> {\n  const analyzer = new DeepAnalyzer({ projectRoot, docsPath });\n  return analyzer.analyze();\n}\n"],"names":[],"mappings":"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"}

package/dist/generators/doc-cultivator.js

@@ -356,10 +356,8 @@ async function executeSwarmTask(task, options) {
   return new Promise((resolve) => {
     const agentProcess = spawn("claude-flow", [
       "agent",
-      "spawn",
-      "--type",
+      "run",
       task.agentType,
-      "--task",
       task.prompt.slice(0, 1e3)
       // Truncate for CLI
     ], {