@weavelogic/knowledge-graph-agent 0.10.0 → 0.10.2

package/README.md

@@ -10,8 +10,9 @@ A powerful NPM library for creating and managing knowledge graphs for Claude Cod
 | Category | Features |
 |----------|----------|
 | **Core** | Knowledge graph generation, Obsidian integration, CLAUDE.md management |
-| **Cultivation** | Codebase analysis, seed generation, deep analysis with claude-flow |
+| **Cultivation** | Codebase analysis, seed generation, deep analysis with claude-flow, doc cultivation |
 | **Agents** | Multi-agent system, rules engine, workflows, MCP server with 30+ tools |
+| **Claude Hooks** | Capture all interactions, hierarchical storage, sub-agent tracking, swarm tracking |
 | **Services** | Service management, config migrations, health monitoring |
 | **Enterprise** | Chunking, backup/recovery, advanced caching, diagnostics |
 | **Integrations** | Workflow DevKit, RuVector semantic search, Exochain audit trail |
@@ -431,6 +432,110 @@ npx @weavelogic/knowledge-graph-agent mcp start
 
 ---
 
+## Claude Code Hooks
+
+Capture all Claude Code interactions and store them in a hierarchical knowledge graph structure.
+
+### Installation
+
+```bash
+# Install hooks to capture all interactions
+kg hooks install
+
+# Check hooks status
+kg hooks status
+
+# View captured sessions
+kg hooks sessions
+```
+
+### Features
+
+- **Hierarchical Storage**: Sessions → Conversations → Messages → Tool Calls
+- **Sub-Agent Tracking**: Automatically tracks Task tool spawns
+- **Swarm Tracking**: Captures claude-flow swarm operations
+- **Markdown Generation**: Creates documentation for all interactions
+- **Tool Output Separation**: Stores tool outputs in dedicated files
+
+### Hook Events Captured
+
+| Event | Description |
+|-------|-------------|
+| `UserPromptSubmit` | All user prompts |
+| `PreToolUse` | Tool invocations with inputs |
+| `PostToolUse` | Tool results and outputs |
+| `Stop` | Session completion |
+| `PreCompact` | Before context compaction |
+
+### Storage Structure
+
+```
+.kg/claude/
+├── sessions/           # JSON session data
+├── agents/            # Sub-agent tracking
+├── tool-outputs/      # Separated tool outputs
+├── docs/
+│   ├── sessions/      # Session markdown docs
+│   ├── conversations/ # Conversation logs
+│   └── agents/        # Sub-agent markdown docs
+```
+
+### Programmatic Usage
+
+```typescript
+import { HookCaptureSystem, generateHookConfig } from '@weavelogic/knowledge-graph-agent';
+
+// Create capture system
+const capture = new HookCaptureSystem('/project', {
+  createMarkdown: true,
+  separateToolOutputs: true,
+  captureSubAgents: true,
+  captureSwarms: true,
+});
+
+// Start a session
+const session = capture.startSession('Development Session', 'Feature implementation');
+
+// Handle hook events
+capture.handleHookEvent({
+  event: 'UserPromptSubmit',
+  timestamp: new Date().toISOString(),
+  userPrompt: 'Help me implement...',
+});
+
+// End session
+const completedSession = capture.endSession();
+```
+
+---
+
+## Document Cultivation
+
+Automatically build out comprehensive documentation using claude-flow swarm orchestration.
+
+### Usage
+
+```bash
+# Cultivate documentation with swarm agents
+kg cultivate --path /project
+
+# Include SOP compliance analysis
+kg cultivate --include-sops
+
+# Dry run to preview
+kg cultivate --dry-run
+```
+
+### Features
+
+- **7-Phase Cultivation Process**: Structure analysis through completion
+- **Development Planning**: Generates phased development plans
+- **Infrastructure Planning**: Creates dev/staging/production infrastructure plans
+- **SOP Compliance**: Integrates AI-SDLC SOP analysis
+- **Swarm Orchestration**: Uses claude-flow for parallel documentation generation
+
+---
+
 ## Enterprise Features
 
 ### Chunker for Large Documents
@@ -592,13 +697,25 @@ const execution = await workflow.start('document-analysis', {
 | `kg dashboard serve` | Serve production build |
 | `kg dashboard status` | Check dashboard status |
 
-### Documentation
+### Documentation & Cultivation
 
 | Command | Description |
 |---------|-------------|
 | `kg docs init` | Initialize docs directory |
 | `kg analyze` | Analyze & migrate to knowledge graph |
 | `kg convert docs` | Convert docs/ to docs-nn/ |
+| `kg cultivate` | Cultivate docs using swarm orchestration |
+| `kg cultivate --include-sops` | Include SOP compliance analysis |
+
+### Claude Code Hooks
+
+| Command | Description |
+|---------|-------------|
+| `kg hooks install` | Install hooks to capture interactions |
+| `kg hooks uninstall` | Remove hooks configuration |
+| `kg hooks status` | Show hooks status |
+| `kg hooks sessions` | List captured sessions |
+| `kg hooks export` | Export captured sessions |
 
 ### Configuration
 
@@ -724,6 +841,53 @@ import {
 
 ## Changelog
 
+### v0.10.1
+
+**Default Directory Fix:**
+- Changed default target directory from `docs-nn` to `docs`
+- `kg analyze`, `kg convert docs`, and related commands now output to `docs/` by default
+- Use `--target docs-nn` if you specifically need the old behavior
+- Updated help text and documentation to reflect the change
+
+### v0.10.0
+
+**Claude Code Hooks System:**
+- **Hook Capture System** - Capture all Claude interactions (prompts, responses, tool calls)
+- **Hierarchical Storage** - Sessions → Conversations → Messages → Tool Calls
+- **Sub-Agent Tracking** - Automatically tracks Task tool spawns with full context
+- **Swarm Tracking** - Captures claude-flow swarm operations
+- **Markdown Generation** - Creates documentation for sessions, conversations, agents
+- **Tool Output Separation** - Stores tool outputs in dedicated JSON files
+- **CLI Commands** - `kg hooks install/uninstall/status/sessions/export`
+- Comprehensive type definitions with Zod validation
+- 22 new tests for hook system
+
+### v0.9.0
+
+**Document Cultivation System:**
+- **Doc Cultivation Command** - `kg cultivate` for automated documentation buildout
+- **7-Phase Cultivation Process** - Structure → Content → Architecture → Development → Infrastructure → Review → Completion
+- **Development Planning** - Generates phased development plans with tasks
+- **Infrastructure Planning** - Creates dev/staging/production infrastructure plans
+- **SOP Compliance Analysis** - Integrates AI-SDLC SOP requirements
+- **Swarm Orchestration** - Uses claude-flow for parallel documentation generation
+- Support for multi-service projects (api, backend, frontend, admin)
+
+### v0.8.8
+
+- Added `src/{service}/docs` directory scanning and copying for doc generation
+- Enhanced service documentation detection
+
+### v0.8.7
+
+- Improved Python project detection for doc generation
+- Better handling of `requirements.txt` and `pyproject.toml`
+
+### v0.8.6
+
+- Fixed vault-sync.test.ts timeout issues
+- Improved test stability
+
 ### v0.7.4
 
 - Fixed repository URL in package.json to match actual GitHub repo name

package/dist/agents/base-agent.js

@@ -525,11 +525,11 @@ class BaseAgent {
     const namespace = this.config.claudeFlow?.namespace ?? "knowledge-graph";
     switch (hookType) {
       case "pre-task":
-        return `npx claude-flow@alpha hooks pre-task --description "${task.description}"`;
+        return `claude-flow hooks pre-task --description "${task.description}"`;
       case "post-task":
-        return `npx claude-flow@alpha hooks post-task --task-id "${task.id}"`;
+        return `claude-flow hooks post-task --task-id "${task.id}"`;
       case "post-edit":
-        return `npx claude-flow@alpha hooks post-edit --memory-key "${namespace}/agent/${this.config.id}/task/${task.id}"`;
+        return `claude-flow hooks post-edit --memory-key "${namespace}/agent/${this.config.id}/task/${task.id}"`;
       default:
         return "";
     }

package/dist/agents/base-agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-agent.js","sources":["../../src/agents/base-agent.ts"],"sourcesContent":["/**\n * Base Agent Implementation\n *\n * Abstract base class for all agents providing common functionality\n * including task execution, input validation, output formatting,\n * error handling, and optional claude-flow integration.\n *\n * @module agents/base-agent\n */\n\nimport { getLogger, retry, type Logger, type RetryOptions } from '../utils/index.js';\nimport {\n  AgentType,\n  AgentStatus,\n  TaskPriority,\n  MessageType,\n  type AgentConfig,\n  type AgentInstance,\n  type AgentState,\n  type AgentTask,\n  type AgentResult,\n  type AgentError,\n  type AgentMessage,\n  type ExecutionMetrics,\n  type ResultArtifact,\n  createAgentId,\n  createTaskId,\n} from './types.js';\nimport {\n  TrajectoryTracker,\n  type TrajectoryTrackerConfig,\n} from '../learning/services/trajectory-tracker.js';\nimport type { TrajectoryStep } from '../integrations/agentic-flow/adapters/reasoning-bank-adapter.js';\n\n// ============================================================================\n// Base Agent Abstract Class\n// ============================================================================\n\n/**\n * Abstract base class for all agents\n *\n * Provides common functionality that all agents share, including:\n * - Task execution with timeout and retry handling\n * - Input validation\n * - Output formatting\n * - Error handling and logging\n * - Optional claude-flow hooks integration\n *\n * @example\n * ```typescript\n * class ResearchAgent extends BaseAgent {\n *   protected async executeTask(task: AgentTask): Promise<AgentResult> {\n *     // Implementation specific to researcher agent\n *     const results = await this.searchSources(task.input);\n *     return this.formatOutput(results);\n *   }\n * }\n * ```\n */\nexport abstract class BaseAgent implements AgentInstance {\n  /** Agent configuration */\n  public readonly config: AgentConfig;\n\n  /** Agent runtime state */\n  private _state: AgentState;\n\n  /** Logger instance */\n  protected readonly logger: Logger;\n\n  /** Message handlers for different message types */\n  private messageHandlers: Map<MessageType, (message: AgentMessage) => Promise<void>> =\n    new Map();\n\n  /** Trajectory tracker for learning */\n  protected trajectoryTracker: TrajectoryTracker | null = null;\n\n  /** Current active trajectory ID */\n  protected currentTrajectoryId: string | null = null;\n\n  /** Whether to auto-track trajectories */\n  protected autoTrackTrajectories: boolean = true;\n\n  constructor(config: AgentConfig) {\n    // Ensure ID is set\n    this.config = {\n      ...config,\n      id: config.id ?? createAgentId(config.type),\n    };\n\n    // Initialize state\n    this._state = {\n      id: this.config.id!,\n      status: AgentStatus.IDLE,\n      taskQueue: [],\n      completedTasks: [],\n      lastActivity: new Date(),\n      errorCount: 0,\n    };\n\n    // Create logger\n    this.logger = getLogger().child(`agent:${this.config.name}`);\n\n    // Register default message handlers\n    this.registerDefaultMessageHandlers();\n  }\n\n  // ============================================================================\n  // State Management\n  // ============================================================================\n\n  /**\n   * Get current agent state\n   */\n  get state(): AgentState {\n    return { ...this._state };\n  }\n\n  /**\n   * Get current agent status\n   */\n  getStatus(): AgentStatus {\n    return this._state.status;\n  }\n\n  /**\n   * Update agent status\n   */\n  protected setStatus(status: AgentStatus): void {\n    const previousStatus = this._state.status;\n    this._state.status = status;\n    this._state.lastActivity = new Date();\n\n    if (previousStatus !== status) {\n      this.logger.debug(`Status changed: ${previousStatus} -> ${status}`);\n    }\n  }\n\n  // ============================================================================\n  // Task Execution\n  // ============================================================================\n\n  /**\n   * Execute a task\n   *\n   * This is the main entry point for task execution. It handles:\n   * - Pre-task hooks (if enabled)\n   * - Input validation\n   * - Retry logic\n   * - Timeout handling\n   * - Post-task hooks (if enabled)\n   * - Error handling and logging\n   */\n  async execute(task: AgentTask): Promise<AgentResult> {\n    const startTime = new Date();\n\n    this.logger.info(`Executing task: ${task.id}`, {\n      description: task.description,\n      priority: task.priority,\n    });\n\n    // Run pre-task hook if enabled\n    if (this.config.claudeFlow?.hooks?.preTask) {\n      await this.runClaudeFlowHook('pre-task', task);\n    }\n\n    // Start trajectory tracking if enabled\n    if (this.autoTrackTrajectories && this.trajectoryTracker?.isEnabled()) {\n      this.startTrajectory(task.id, {\n        description: task.description,\n        priority: task.priority,\n        input: task.input,\n      });\n      this.recordStep('task_started', `Starting task: ${task.description}`, 1.0);\n    }\n\n    try {\n      // Validate input\n      const validationResult = await this.validateInput(task);\n      if (!validationResult.valid) {\n        this.recordStep('validation_failed', validationResult.error ?? 'Input validation failed', 0.0);\n        await this.completeTrajectory('failure', { validationError: validationResult.error });\n        return this.createErrorResult(\n          'VALIDATION_ERROR',\n          validationResult.error ?? 'Input validation failed',\n          startTime\n        );\n      }\n\n      this.recordStep('validation_passed', 'Input validation successful', 1.0);\n\n      // Set status to running\n      this.setStatus(AgentStatus.RUNNING);\n      this._state.currentTask = task;\n\n      // Execute with retry if configured\n      let result: AgentResult;\n      const retryConfig = this.config.retry;\n\n      if (retryConfig && retryConfig.maxRetries > 0) {\n        const retryOptions: RetryOptions = {\n          maxRetries: retryConfig.maxRetries,\n          initialDelay: retryConfig.backoffMs,\n          backoffFactor: retryConfig.backoffMultiplier ?? 2,\n          isRetryable: (error: unknown) => this.isRetryableError(error),\n        };\n\n        result = await retry(\n          async () => this.executeWithTimeout(task),\n          retryOptions\n        );\n      } else {\n        result = await this.executeWithTimeout(task);\n      }\n\n      // Update state on success\n      if (result.success) {\n        this._state.completedTasks.push(task.id);\n        this.setStatus(AgentStatus.COMPLETED);\n        this.recordStep('task_completed', 'Task completed successfully', 1.0, { success: true });\n        await this.completeTrajectory('success', {\n          durationMs: result.metrics?.durationMs,\n          artifactCount: result.artifacts?.length ?? 0,\n        });\n      } else {\n        this._state.errorCount++;\n        this.setStatus(AgentStatus.FAILED);\n        this.recordStep('task_failed', result.error?.message ?? 'Task failed', 0.0, { error: result.error });\n        await this.completeTrajectory('failure', {\n          errorCode: result.error?.code,\n          errorMessage: result.error?.message,\n        });\n      }\n\n      // Add metrics\n      result.metrics = this.calculateMetrics(startTime, new Date());\n\n      // Run post-task hook if enabled\n      if (this.config.claudeFlow?.hooks?.postTask) {\n        await this.runClaudeFlowHook('post-task', task, result);\n      }\n\n      return result;\n    } catch (error) {\n      this._state.errorCount++;\n      this.setStatus(AgentStatus.FAILED);\n\n      const agentError = this.normalizeError(error);\n      this.logger.error(`Task execution failed: ${task.id}`, error as Error);\n\n      // Record trajectory failure\n      this.recordStep('task_exception', agentError.message, 0.0, {\n        errorCode: agentError.code,\n        stack: agentError.stack,\n      });\n      await this.completeTrajectory('failure', {\n        exception: true,\n        errorCode: agentError.code,\n        errorMessage: agentError.message,\n      });\n\n      return this.createErrorResult(agentError.code, agentError.message, startTime, {\n        stack: agentError.stack,\n        retryable: agentError.retryable,\n      });\n    } finally {\n      this._state.currentTask = undefined;\n      this._state.lastActivity = new Date();\n    }\n  }\n\n  /**\n   * Execute task with timeout\n   */\n  private async executeWithTimeout(task: AgentTask): Promise<AgentResult> {\n    const timeout = task.timeout ?? this.config.taskTimeout ?? 30000;\n\n    return new Promise<AgentResult>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        reject(new Error(`Task execution timed out after ${timeout}ms`));\n      }, timeout);\n\n      this.executeTask(task)\n        .then((result) => {\n          clearTimeout(timer);\n          resolve(result);\n        })\n        .catch((error) => {\n          clearTimeout(timer);\n          reject(error);\n        });\n    });\n  }\n\n  /**\n   * Abstract method for actual task execution\n   *\n   * Subclasses must implement this method with their specific logic.\n   */\n  protected abstract executeTask(task: AgentTask): Promise<AgentResult>;\n\n  // ============================================================================\n  // Input Validation\n  // ============================================================================\n\n  /**\n   * Validate task input\n   *\n   * Override this method to implement custom validation logic.\n   */\n  async validateInput(task: AgentTask): Promise<{ valid: boolean; error?: string }> {\n    // Basic validation\n    if (!task.id) {\n      return { valid: false, error: 'Task ID is required' };\n    }\n\n    if (!task.description) {\n      return { valid: false, error: 'Task description is required' };\n    }\n\n    // Check dependencies are resolved\n    if (task.dependencies && task.dependencies.length > 0) {\n      const unresolvedDeps = task.dependencies.filter(\n        (dep) => !this._state.completedTasks.includes(dep)\n      );\n\n      if (unresolvedDeps.length > 0) {\n        return {\n          valid: false,\n          error: `Unresolved dependencies: ${unresolvedDeps.join(', ')}`,\n        };\n      }\n    }\n\n    return { valid: true };\n  }\n\n  // ============================================================================\n  // Output Formatting\n  // ============================================================================\n\n  /**\n   * Format successful output\n   */\n  formatOutput<T>(data: T, artifacts?: ResultArtifact[]): AgentResult<T> {\n    return {\n      success: true,\n      data,\n      artifacts,\n      metadata: {\n        agentId: this.config.id,\n        agentType: this.config.type,\n        timestamp: new Date().toISOString(),\n      },\n    };\n  }\n\n  /**\n   * Create a success result\n   */\n  protected createSuccessResult<T>(\n    data: T,\n    startTime: Date,\n    artifacts?: ResultArtifact[]\n  ): AgentResult<T> {\n    return {\n      success: true,\n      data,\n      artifacts,\n      metrics: this.calculateMetrics(startTime, new Date()),\n      metadata: {\n        agentId: this.config.id,\n        agentType: this.config.type,\n      },\n    };\n  }\n\n  /**\n   * Create an error result\n   */\n  protected createErrorResult(\n    code: string,\n    message: string,\n    startTime: Date,\n    details?: Partial<AgentError>\n  ): AgentResult {\n    return {\n      success: false,\n      error: {\n        code,\n        message,\n        ...details,\n      },\n      metrics: this.calculateMetrics(startTime, new Date()),\n      metadata: {\n        agentId: this.config.id,\n        agentType: this.config.type,\n      },\n    };\n  }\n\n  /**\n   * Calculate execution metrics\n   */\n  private calculateMetrics(startTime: Date, endTime: Date): ExecutionMetrics {\n    return {\n      startTime,\n      endTime,\n      durationMs: endTime.getTime() - startTime.getTime(),\n      memoryUsage: process.memoryUsage?.().heapUsed,\n      retries: 0, // Updated by retry logic if needed\n    };\n  }\n\n  // ============================================================================\n  // Error Handling\n  // ============================================================================\n\n  /**\n   * Normalize error to AgentError format\n   */\n  private normalizeError(error: unknown): AgentError {\n    if (error instanceof Error) {\n      return {\n        code: error.name || 'UNKNOWN_ERROR',\n        message: error.message,\n        stack: error.stack,\n        retryable: this.isRetryableError(error),\n      };\n    }\n\n    return {\n      code: 'UNKNOWN_ERROR',\n      message: String(error),\n      retryable: false,\n    };\n  }\n\n  /**\n   * Check if an error is retryable\n   */\n  protected isRetryableError(error: unknown): boolean {\n    if (error instanceof Error) {\n      const message = error.message.toLowerCase();\n\n      // Network/transient errors\n      if (\n        message.includes('timeout') ||\n        message.includes('network') ||\n        message.includes('connection') ||\n        message.includes('econnreset') ||\n        message.includes('rate limit')\n      ) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  // ============================================================================\n  // Lifecycle Methods\n  // ============================================================================\n\n  /**\n   * Pause the agent\n   */\n  async pause(): Promise<void> {\n    if (this._state.status === AgentStatus.RUNNING) {\n      this.logger.info('Pausing agent');\n      this.setStatus(AgentStatus.PAUSED);\n    }\n  }\n\n  /**\n   * Resume the agent\n   */\n  async resume(): Promise<void> {\n    if (this._state.status === AgentStatus.PAUSED) {\n      this.logger.info('Resuming agent');\n      this.setStatus(AgentStatus.IDLE);\n    }\n  }\n\n  /**\n   * Terminate the agent\n   */\n  async terminate(): Promise<void> {\n    this.logger.info('Terminating agent');\n\n    // Clean up any resources\n    await this.cleanup();\n\n    this.setStatus(AgentStatus.TERMINATED);\n  }\n\n  /**\n   * Cleanup resources\n   *\n   * Override to implement custom cleanup logic.\n   */\n  protected async cleanup(): Promise<void> {\n    // Default: no cleanup needed\n  }\n\n  // ============================================================================\n  // Messaging\n  // ============================================================================\n\n  /**\n   * Send a message to another agent\n   */\n  async sendMessage(message: AgentMessage): Promise<void> {\n    this.logger.debug(`Sending message to ${message.to}`, {\n      type: message.type,\n      correlationId: message.correlationId,\n    });\n\n    // In a real implementation, this would use a message bus\n    // For now, just log the message\n    this.logger.trace('Message payload', { payload: message.payload });\n  }\n\n  /**\n   * Receive and process a message\n   */\n  async receiveMessage(message: AgentMessage): Promise<void> {\n    this.logger.debug(`Received message from ${message.from}`, {\n      type: message.type,\n      correlationId: message.correlationId,\n    });\n\n    const handler = this.messageHandlers.get(message.type);\n    if (handler) {\n      await handler(message);\n    } else {\n      this.logger.warn(`No handler for message type: ${message.type}`);\n    }\n  }\n\n  /**\n   * Register a message handler\n   */\n  protected registerMessageHandler(\n    type: MessageType,\n    handler: (message: AgentMessage) => Promise<void>\n  ): void {\n    this.messageHandlers.set(type, handler);\n  }\n\n  /**\n   * Register default message handlers\n   */\n  private registerDefaultMessageHandlers(): void {\n    // Handle status requests\n    this.registerMessageHandler(MessageType.STATUS, async (message) => {\n      await this.sendMessage({\n        id: `${Date.now()}`,\n        type: MessageType.STATUS,\n        from: this.config.id!,\n        to: message.from,\n        timestamp: new Date(),\n        correlationId: message.id,\n        payload: {\n          agentId: this.config.id,\n          status: this._state.status,\n          currentTask: this._state.currentTask?.id,\n        },\n      });\n    });\n  }\n\n  // ============================================================================\n  // Trajectory Tracking\n  // ============================================================================\n\n  /**\n   * Set the trajectory tracker for this agent\n   *\n   * @param tracker - The trajectory tracker instance\n   */\n  setTrajectoryTracker(tracker: TrajectoryTracker): void {\n    this.trajectoryTracker = tracker;\n  }\n\n  /**\n   * Enable or disable auto-tracking of trajectories\n   *\n   * @param enabled - Whether to auto-track\n   */\n  setAutoTrackTrajectories(enabled: boolean): void {\n    this.autoTrackTrajectories = enabled;\n  }\n\n  /**\n   * Start tracking a task trajectory\n   *\n   * @param taskId - The task ID to track\n   * @param metadata - Optional metadata\n   * @returns The trajectory ID\n   */\n  protected startTrajectory(\n    taskId: string,\n    metadata: Record<string, unknown> = {}\n  ): string | null {\n    if (!this.trajectoryTracker?.isEnabled()) {\n      return null;\n    }\n\n    this.currentTrajectoryId = this.trajectoryTracker.startTrajectory(taskId, {\n      ...metadata,\n      agentId: this.config.id,\n      agentType: this.config.type,\n      agentName: this.config.name,\n    });\n\n    return this.currentTrajectoryId;\n  }\n\n  /**\n   * Record a step in the current trajectory\n   *\n   * @param action - The action taken\n   * @param observation - The observation/result\n   * @param confidence - Optional confidence score (0-1)\n   * @param metadata - Optional step metadata\n   */\n  protected recordStep(\n    action: string,\n    observation: string,\n    confidence?: number,\n    metadata?: Record<string, unknown>\n  ): void {\n    if (!this.trajectoryTracker || !this.currentTrajectoryId) {\n      return;\n    }\n\n    this.trajectoryTracker.recordStep(this.currentTrajectoryId, {\n      action,\n      observation,\n      confidence,\n      metadata,\n    });\n  }\n\n  /**\n   * Complete the current trajectory\n   *\n   * @param outcome - The task outcome\n   * @param metadata - Optional final metadata\n   * @returns The stored trajectory ID, or null\n   */\n  protected async completeTrajectory(\n    outcome: 'success' | 'failure' | 'partial',\n    metadata: Record<string, unknown> = {}\n  ): Promise<string | null> {\n    if (!this.trajectoryTracker || !this.currentTrajectoryId) {\n      return null;\n    }\n\n    const storedId = await this.trajectoryTracker.completeTrajectory(\n      this.currentTrajectoryId,\n      outcome,\n      metadata\n    );\n\n    this.currentTrajectoryId = null;\n    return storedId;\n  }\n\n  /**\n   * Abort the current trajectory\n   *\n   * @param reason - The reason for aborting\n   */\n  protected abortTrajectory(reason: string): void {\n    if (!this.trajectoryTracker || !this.currentTrajectoryId) {\n      return;\n    }\n\n    this.trajectoryTracker.abortTrajectory(this.currentTrajectoryId, reason);\n    this.currentTrajectoryId = null;\n  }\n\n  /**\n   * Check if trajectory tracking is active\n   */\n  isTrackingTrajectory(): boolean {\n    return this.currentTrajectoryId !== null;\n  }\n\n  /**\n   * Get current trajectory progress\n   */\n  getTrajectoryProgress(): {\n    stepCount: number;\n    duration: number;\n    lastStep?: TrajectoryStep;\n  } | null {\n    if (!this.trajectoryTracker || !this.currentTrajectoryId) {\n      return null;\n    }\n\n    return this.trajectoryTracker.getProgress(this.currentTrajectoryId);\n  }\n\n  // ============================================================================\n  // Claude-Flow Integration\n  // ============================================================================\n\n  /**\n   * Run a claude-flow hook\n   */\n  protected async runClaudeFlowHook(\n    hookType: 'pre-task' | 'post-task' | 'post-edit',\n    task: AgentTask,\n    result?: AgentResult\n  ): Promise<void> {\n    if (!this.config.claudeFlow?.enabled) {\n      return;\n    }\n\n    const namespace = this.config.claudeFlow.namespace ?? 'knowledge-graph';\n\n    this.logger.debug(`Running claude-flow hook: ${hookType}`, {\n      namespace,\n      taskId: task.id,\n    });\n\n    // Generate the hook command that would be run\n    const hookCommand = this.generateHookCommand(hookType, task, result);\n\n    this.logger.trace('Claude-flow hook command', { command: hookCommand });\n\n    // In production, this would execute via child_process or MCP\n    // For now, we just log the intent\n  }\n\n  /**\n   * Generate claude-flow hook command\n   */\n  private generateHookCommand(\n    hookType: 'pre-task' | 'post-task' | 'post-edit',\n    task: AgentTask,\n    result?: AgentResult\n  ): string {\n    const namespace = this.config.claudeFlow?.namespace ?? 'knowledge-graph';\n\n    switch (hookType) {\n      case 'pre-task':\n        return `npx claude-flow@alpha hooks pre-task --description \"${task.description}\"`;\n\n      case 'post-task':\n        return `npx claude-flow@alpha hooks post-task --task-id \"${task.id}\"`;\n\n      case 'post-edit':\n        return `npx claude-flow@alpha hooks post-edit --memory-key \"${namespace}/agent/${this.config.id}/task/${task.id}\"`;\n\n      default:\n        return '';\n    }\n  }\n\n  /**\n   * Store result in claude-flow memory\n   */\n  protected async storeInMemory(key: string, value: unknown): Promise<void> {\n    if (!this.config.claudeFlow?.enabled) {\n      return;\n    }\n\n    const namespace = this.config.claudeFlow.namespace ?? 'knowledge-graph';\n\n    this.logger.debug('Storing in claude-flow memory', { namespace, key });\n\n    // This would call the MCP memory_usage tool\n    // For now, just log the intent\n    this.logger.trace('Memory store', {\n      action: 'store',\n      namespace,\n      key,\n      value: JSON.stringify(value).slice(0, 100),\n    });\n  }\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Create a task with defaults\n */\nexport function createTask(\n  description: string,\n  options?: Partial<Omit<AgentTask, 'id' | 'description' | 'createdAt'>>\n): AgentTask {\n  return {\n    id: createTaskId(),\n    description,\n    priority: options?.priority ?? TaskPriority.MEDIUM,\n    input: options?.input ?? {},\n    expectedOutput: options?.expectedOutput,\n    dependencies: options?.dependencies,\n    timeout: options?.timeout,\n    metadata: options?.metadata,\n    createdAt: new Date(),\n    deadline: options?.deadline,\n  };\n}\n\n/**\n * Type guard for checking if an object is an AgentResult\n */\nexport function isAgentResult(obj: unknown): obj is AgentResult {\n  return (\n    typeof obj === 'object' &&\n    obj !== null &&\n    'success' in obj &&\n    typeof (obj as AgentResult).success === 'boolean'\n  );\n}\n\n/**\n * Type guard for checking if an object is an AgentError\n */\nexport function isAgentError(obj: unknown): obj is AgentError {\n  return (\n    typeof obj === 'object' &&\n    obj !== null &&\n    'code' in obj &&\n    'message' in obj &&\n    typeof (obj as AgentError).code === 'string' &&\n    typeof (obj as AgentError).message === 'string'\n  );\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-agent.js","sources":["../../src/agents/base-agent.ts"],"sourcesContent":["/**\n * Base Agent Implementation\n *\n * Abstract base class for all agents providing common functionality\n * including task execution, input validation, output formatting,\n * error handling, and optional claude-flow integration.\n *\n * @module agents/base-agent\n */\n\nimport { getLogger, retry, type Logger, type RetryOptions } from '../utils/index.js';\nimport {\n  AgentType,\n  AgentStatus,\n  TaskPriority,\n  MessageType,\n  type AgentConfig,\n  type AgentInstance,\n  type AgentState,\n  type AgentTask,\n  type AgentResult,\n  type AgentError,\n  type AgentMessage,\n  type ExecutionMetrics,\n  type ResultArtifact,\n  createAgentId,\n  createTaskId,\n} from './types.js';\nimport {\n  TrajectoryTracker,\n  type TrajectoryTrackerConfig,\n} from '../learning/services/trajectory-tracker.js';\nimport type { TrajectoryStep } from '../integrations/agentic-flow/adapters/reasoning-bank-adapter.js';\n\n// ============================================================================\n// Base Agent Abstract Class\n// ============================================================================\n\n/**\n * Abstract base class for all agents\n *\n * Provides common functionality that all agents share, including:\n * - Task execution with timeout and retry handling\n * - Input validation\n * - Output formatting\n * - Error handling and logging\n * - Optional claude-flow hooks integration\n *\n * @example\n * ```typescript\n * class ResearchAgent extends BaseAgent {\n *   protected async executeTask(task: AgentTask): Promise<AgentResult> {\n *     // Implementation specific to researcher agent\n *     const results = await this.searchSources(task.input);\n *     return this.formatOutput(results);\n *   }\n * }\n * ```\n */\nexport abstract class BaseAgent implements AgentInstance {\n  /** Agent configuration */\n  public readonly config: AgentConfig;\n\n  /** Agent runtime state */\n  private _state: AgentState;\n\n  /** Logger instance */\n  protected readonly logger: Logger;\n\n  /** Message handlers for different message types */\n  private messageHandlers: Map<MessageType, (message: AgentMessage) => Promise<void>> =\n    new Map();\n\n  /** Trajectory tracker for learning */\n  protected trajectoryTracker: TrajectoryTracker | null = null;\n\n  /** Current active trajectory ID */\n  protected currentTrajectoryId: string | null = null;\n\n  /** Whether to auto-track trajectories */\n  protected autoTrackTrajectories: boolean = true;\n\n  constructor(config: AgentConfig) {\n    // Ensure ID is set\n    this.config = {\n      ...config,\n      id: config.id ?? createAgentId(config.type),\n    };\n\n    // Initialize state\n    this._state = {\n      id: this.config.id!,\n      status: AgentStatus.IDLE,\n      taskQueue: [],\n      completedTasks: [],\n      lastActivity: new Date(),\n      errorCount: 0,\n    };\n\n    // Create logger\n    this.logger = getLogger().child(`agent:${this.config.name}`);\n\n    // Register default message handlers\n    this.registerDefaultMessageHandlers();\n  }\n\n  // ============================================================================\n  // State Management\n  // ============================================================================\n\n  /**\n   * Get current agent state\n   */\n  get state(): AgentState {\n    return { ...this._state };\n  }\n\n  /**\n   * Get current agent status\n   */\n  getStatus(): AgentStatus {\n    return this._state.status;\n  }\n\n  /**\n   * Update agent status\n   */\n  protected setStatus(status: AgentStatus): void {\n    const previousStatus = this._state.status;\n    this._state.status = status;\n    this._state.lastActivity = new Date();\n\n    if (previousStatus !== status) {\n      this.logger.debug(`Status changed: ${previousStatus} -> ${status}`);\n    }\n  }\n\n  // ============================================================================\n  // Task Execution\n  // ============================================================================\n\n  /**\n   * Execute a task\n   *\n   * This is the main entry point for task execution. It handles:\n   * - Pre-task hooks (if enabled)\n   * - Input validation\n   * - Retry logic\n   * - Timeout handling\n   * - Post-task hooks (if enabled)\n   * - Error handling and logging\n   */\n  async execute(task: AgentTask): Promise<AgentResult> {\n    const startTime = new Date();\n\n    this.logger.info(`Executing task: ${task.id}`, {\n      description: task.description,\n      priority: task.priority,\n    });\n\n    // Run pre-task hook if enabled\n    if (this.config.claudeFlow?.hooks?.preTask) {\n      await this.runClaudeFlowHook('pre-task', task);\n    }\n\n    // Start trajectory tracking if enabled\n    if (this.autoTrackTrajectories && this.trajectoryTracker?.isEnabled()) {\n      this.startTrajectory(task.id, {\n        description: task.description,\n        priority: task.priority,\n        input: task.input,\n      });\n      this.recordStep('task_started', `Starting task: ${task.description}`, 1.0);\n    }\n\n    try {\n      // Validate input\n      const validationResult = await this.validateInput(task);\n      if (!validationResult.valid) {\n        this.recordStep('validation_failed', validationResult.error ?? 'Input validation failed', 0.0);\n        await this.completeTrajectory('failure', { validationError: validationResult.error });\n        return this.createErrorResult(\n          'VALIDATION_ERROR',\n          validationResult.error ?? 'Input validation failed',\n          startTime\n        );\n      }\n\n      this.recordStep('validation_passed', 'Input validation successful', 1.0);\n\n      // Set status to running\n      this.setStatus(AgentStatus.RUNNING);\n      this._state.currentTask = task;\n\n      // Execute with retry if configured\n      let result: AgentResult;\n      const retryConfig = this.config.retry;\n\n      if (retryConfig && retryConfig.maxRetries > 0) {\n        const retryOptions: RetryOptions = {\n          maxRetries: retryConfig.maxRetries,\n          initialDelay: retryConfig.backoffMs,\n          backoffFactor: retryConfig.backoffMultiplier ?? 2,\n          isRetryable: (error: unknown) => this.isRetryableError(error),\n        };\n\n        result = await retry(\n          async () => this.executeWithTimeout(task),\n          retryOptions\n        );\n      } else {\n        result = await this.executeWithTimeout(task);\n      }\n\n      // Update state on success\n      if (result.success) {\n        this._state.completedTasks.push(task.id);\n        this.setStatus(AgentStatus.COMPLETED);\n        this.recordStep('task_completed', 'Task completed successfully', 1.0, { success: true });\n        await this.completeTrajectory('success', {\n          durationMs: result.metrics?.durationMs,\n          artifactCount: result.artifacts?.length ?? 0,\n        });\n      } else {\n        this._state.errorCount++;\n        this.setStatus(AgentStatus.FAILED);\n        this.recordStep('task_failed', result.error?.message ?? 'Task failed', 0.0, { error: result.error });\n        await this.completeTrajectory('failure', {\n          errorCode: result.error?.code,\n          errorMessage: result.error?.message,\n        });\n      }\n\n      // Add metrics\n      result.metrics = this.calculateMetrics(startTime, new Date());\n\n      // Run post-task hook if enabled\n      if (this.config.claudeFlow?.hooks?.postTask) {\n        await this.runClaudeFlowHook('post-task', task, result);\n      }\n\n      return result;\n    } catch (error) {\n      this._state.errorCount++;\n      this.setStatus(AgentStatus.FAILED);\n\n      const agentError = this.normalizeError(error);\n      this.logger.error(`Task execution failed: ${task.id}`, error as Error);\n\n      // Record trajectory failure\n      this.recordStep('task_exception', agentError.message, 0.0, {\n        errorCode: agentError.code,\n        stack: agentError.stack,\n      });\n      await this.completeTrajectory('failure', {\n        exception: true,\n        errorCode: agentError.code,\n        errorMessage: agentError.message,\n      });\n\n      return this.createErrorResult(agentError.code, agentError.message, startTime, {\n        stack: agentError.stack,\n        retryable: agentError.retryable,\n      });\n    } finally {\n      this._state.currentTask = undefined;\n      this._state.lastActivity = new Date();\n    }\n  }\n\n  /**\n   * Execute task with timeout\n   */\n  private async executeWithTimeout(task: AgentTask): Promise<AgentResult> {\n    const timeout = task.timeout ?? this.config.taskTimeout ?? 30000;\n\n    return new Promise<AgentResult>((resolve, reject) => {\n      const timer = setTimeout(() => {\n        reject(new Error(`Task execution timed out after ${timeout}ms`));\n      }, timeout);\n\n      this.executeTask(task)\n        .then((result) => {\n          clearTimeout(timer);\n          resolve(result);\n        })\n        .catch((error) => {\n          clearTimeout(timer);\n          reject(error);\n        });\n    });\n  }\n\n  /**\n   * Abstract method for actual task execution\n   *\n   * Subclasses must implement this method with their specific logic.\n   */\n  protected abstract executeTask(task: AgentTask): Promise<AgentResult>;\n\n  // ============================================================================\n  // Input Validation\n  // ============================================================================\n\n  /**\n   * Validate task input\n   *\n   * Override this method to implement custom validation logic.\n   */\n  async validateInput(task: AgentTask): Promise<{ valid: boolean; error?: string }> {\n    // Basic validation\n    if (!task.id) {\n      return { valid: false, error: 'Task ID is required' };\n    }\n\n    if (!task.description) {\n      return { valid: false, error: 'Task description is required' };\n    }\n\n    // Check dependencies are resolved\n    if (task.dependencies && task.dependencies.length > 0) {\n      const unresolvedDeps = task.dependencies.filter(\n        (dep) => !this._state.completedTasks.includes(dep)\n      );\n\n      if (unresolvedDeps.length > 0) {\n        return {\n          valid: false,\n          error: `Unresolved dependencies: ${unresolvedDeps.join(', ')}`,\n        };\n      }\n    }\n\n    return { valid: true };\n  }\n\n  // ============================================================================\n  // Output Formatting\n  // ============================================================================\n\n  /**\n   * Format successful output\n   */\n  formatOutput<T>(data: T, artifacts?: ResultArtifact[]): AgentResult<T> {\n    return {\n      success: true,\n      data,\n      artifacts,\n      metadata: {\n        agentId: this.config.id,\n        agentType: this.config.type,\n        timestamp: new Date().toISOString(),\n      },\n    };\n  }\n\n  /**\n   * Create a success result\n   */\n  protected createSuccessResult<T>(\n    data: T,\n    startTime: Date,\n    artifacts?: ResultArtifact[]\n  ): AgentResult<T> {\n    return {\n      success: true,\n      data,\n      artifacts,\n      metrics: this.calculateMetrics(startTime, new Date()),\n      metadata: {\n        agentId: this.config.id,\n        agentType: this.config.type,\n      },\n    };\n  }\n\n  /**\n   * Create an error result\n   */\n  protected createErrorResult(\n    code: string,\n    message: string,\n    startTime: Date,\n    details?: Partial<AgentError>\n  ): AgentResult {\n    return {\n      success: false,\n      error: {\n        code,\n        message,\n        ...details,\n      },\n      metrics: this.calculateMetrics(startTime, new Date()),\n      metadata: {\n        agentId: this.config.id,\n        agentType: this.config.type,\n      },\n    };\n  }\n\n  /**\n   * Calculate execution metrics\n   */\n  private calculateMetrics(startTime: Date, endTime: Date): ExecutionMetrics {\n    return {\n      startTime,\n      endTime,\n      durationMs: endTime.getTime() - startTime.getTime(),\n      memoryUsage: process.memoryUsage?.().heapUsed,\n      retries: 0, // Updated by retry logic if needed\n    };\n  }\n\n  // ============================================================================\n  // Error Handling\n  // ============================================================================\n\n  /**\n   * Normalize error to AgentError format\n   */\n  private normalizeError(error: unknown): AgentError {\n    if (error instanceof Error) {\n      return {\n        code: error.name || 'UNKNOWN_ERROR',\n        message: error.message,\n        stack: error.stack,\n        retryable: this.isRetryableError(error),\n      };\n    }\n\n    return {\n      code: 'UNKNOWN_ERROR',\n      message: String(error),\n      retryable: false,\n    };\n  }\n\n  /**\n   * Check if an error is retryable\n   */\n  protected isRetryableError(error: unknown): boolean {\n    if (error instanceof Error) {\n      const message = error.message.toLowerCase();\n\n      // Network/transient errors\n      if (\n        message.includes('timeout') ||\n        message.includes('network') ||\n        message.includes('connection') ||\n        message.includes('econnreset') ||\n        message.includes('rate limit')\n      ) {\n        return true;\n      }\n    }\n\n    return false;\n  }\n\n  // ============================================================================\n  // Lifecycle Methods\n  // ============================================================================\n\n  /**\n   * Pause the agent\n   */\n  async pause(): Promise<void> {\n    if (this._state.status === AgentStatus.RUNNING) {\n      this.logger.info('Pausing agent');\n      this.setStatus(AgentStatus.PAUSED);\n    }\n  }\n\n  /**\n   * Resume the agent\n   */\n  async resume(): Promise<void> {\n    if (this._state.status === AgentStatus.PAUSED) {\n      this.logger.info('Resuming agent');\n      this.setStatus(AgentStatus.IDLE);\n    }\n  }\n\n  /**\n   * Terminate the agent\n   */\n  async terminate(): Promise<void> {\n    this.logger.info('Terminating agent');\n\n    // Clean up any resources\n    await this.cleanup();\n\n    this.setStatus(AgentStatus.TERMINATED);\n  }\n\n  /**\n   * Cleanup resources\n   *\n   * Override to implement custom cleanup logic.\n   */\n  protected async cleanup(): Promise<void> {\n    // Default: no cleanup needed\n  }\n\n  // ============================================================================\n  // Messaging\n  // ============================================================================\n\n  /**\n   * Send a message to another agent\n   */\n  async sendMessage(message: AgentMessage): Promise<void> {\n    this.logger.debug(`Sending message to ${message.to}`, {\n      type: message.type,\n      correlationId: message.correlationId,\n    });\n\n    // In a real implementation, this would use a message bus\n    // For now, just log the message\n    this.logger.trace('Message payload', { payload: message.payload });\n  }\n\n  /**\n   * Receive and process a message\n   */\n  async receiveMessage(message: AgentMessage): Promise<void> {\n    this.logger.debug(`Received message from ${message.from}`, {\n      type: message.type,\n      correlationId: message.correlationId,\n    });\n\n    const handler = this.messageHandlers.get(message.type);\n    if (handler) {\n      await handler(message);\n    } else {\n      this.logger.warn(`No handler for message type: ${message.type}`);\n    }\n  }\n\n  /**\n   * Register a message handler\n   */\n  protected registerMessageHandler(\n    type: MessageType,\n    handler: (message: AgentMessage) => Promise<void>\n  ): void {\n    this.messageHandlers.set(type, handler);\n  }\n\n  /**\n   * Register default message handlers\n   */\n  private registerDefaultMessageHandlers(): void {\n    // Handle status requests\n    this.registerMessageHandler(MessageType.STATUS, async (message) => {\n      await this.sendMessage({\n        id: `${Date.now()}`,\n        type: MessageType.STATUS,\n        from: this.config.id!,\n        to: message.from,\n        timestamp: new Date(),\n        correlationId: message.id,\n        payload: {\n          agentId: this.config.id,\n          status: this._state.status,\n          currentTask: this._state.currentTask?.id,\n        },\n      });\n    });\n  }\n\n  // ============================================================================\n  // Trajectory Tracking\n  // ============================================================================\n\n  /**\n   * Set the trajectory tracker for this agent\n   *\n   * @param tracker - The trajectory tracker instance\n   */\n  setTrajectoryTracker(tracker: TrajectoryTracker): void {\n    this.trajectoryTracker = tracker;\n  }\n\n  /**\n   * Enable or disable auto-tracking of trajectories\n   *\n   * @param enabled - Whether to auto-track\n   */\n  setAutoTrackTrajectories(enabled: boolean): void {\n    this.autoTrackTrajectories = enabled;\n  }\n\n  /**\n   * Start tracking a task trajectory\n   *\n   * @param taskId - The task ID to track\n   * @param metadata - Optional metadata\n   * @returns The trajectory ID\n   */\n  protected startTrajectory(\n    taskId: string,\n    metadata: Record<string, unknown> = {}\n  ): string | null {\n    if (!this.trajectoryTracker?.isEnabled()) {\n      return null;\n    }\n\n    this.currentTrajectoryId = this.trajectoryTracker.startTrajectory(taskId, {\n      ...metadata,\n      agentId: this.config.id,\n      agentType: this.config.type,\n      agentName: this.config.name,\n    });\n\n    return this.currentTrajectoryId;\n  }\n\n  /**\n   * Record a step in the current trajectory\n   *\n   * @param action - The action taken\n   * @param observation - The observation/result\n   * @param confidence - Optional confidence score (0-1)\n   * @param metadata - Optional step metadata\n   */\n  protected recordStep(\n    action: string,\n    observation: string,\n    confidence?: number,\n    metadata?: Record<string, unknown>\n  ): void {\n    if (!this.trajectoryTracker || !this.currentTrajectoryId) {\n      return;\n    }\n\n    this.trajectoryTracker.recordStep(this.currentTrajectoryId, {\n      action,\n      observation,\n      confidence,\n      metadata,\n    });\n  }\n\n  /**\n   * Complete the current trajectory\n   *\n   * @param outcome - The task outcome\n   * @param metadata - Optional final metadata\n   * @returns The stored trajectory ID, or null\n   */\n  protected async completeTrajectory(\n    outcome: 'success' | 'failure' | 'partial',\n    metadata: Record<string, unknown> = {}\n  ): Promise<string | null> {\n    if (!this.trajectoryTracker || !this.currentTrajectoryId) {\n      return null;\n    }\n\n    const storedId = await this.trajectoryTracker.completeTrajectory(\n      this.currentTrajectoryId,\n      outcome,\n      metadata\n    );\n\n    this.currentTrajectoryId = null;\n    return storedId;\n  }\n\n  /**\n   * Abort the current trajectory\n   *\n   * @param reason - The reason for aborting\n   */\n  protected abortTrajectory(reason: string): void {\n    if (!this.trajectoryTracker || !this.currentTrajectoryId) {\n      return;\n    }\n\n    this.trajectoryTracker.abortTrajectory(this.currentTrajectoryId, reason);\n    this.currentTrajectoryId = null;\n  }\n\n  /**\n   * Check if trajectory tracking is active\n   */\n  isTrackingTrajectory(): boolean {\n    return this.currentTrajectoryId !== null;\n  }\n\n  /**\n   * Get current trajectory progress\n   */\n  getTrajectoryProgress(): {\n    stepCount: number;\n    duration: number;\n    lastStep?: TrajectoryStep;\n  } | null {\n    if (!this.trajectoryTracker || !this.currentTrajectoryId) {\n      return null;\n    }\n\n    return this.trajectoryTracker.getProgress(this.currentTrajectoryId);\n  }\n\n  // ============================================================================\n  // Claude-Flow Integration\n  // ============================================================================\n\n  /**\n   * Run a claude-flow hook\n   */\n  protected async runClaudeFlowHook(\n    hookType: 'pre-task' | 'post-task' | 'post-edit',\n    task: AgentTask,\n    result?: AgentResult\n  ): Promise<void> {\n    if (!this.config.claudeFlow?.enabled) {\n      return;\n    }\n\n    const namespace = this.config.claudeFlow.namespace ?? 'knowledge-graph';\n\n    this.logger.debug(`Running claude-flow hook: ${hookType}`, {\n      namespace,\n      taskId: task.id,\n    });\n\n    // Generate the hook command that would be run\n    const hookCommand = this.generateHookCommand(hookType, task, result);\n\n    this.logger.trace('Claude-flow hook command', { command: hookCommand });\n\n    // In production, this would execute via child_process or MCP\n    // For now, we just log the intent\n  }\n\n  /**\n   * Generate claude-flow hook command\n   */\n  private generateHookCommand(\n    hookType: 'pre-task' | 'post-task' | 'post-edit',\n    task: AgentTask,\n    result?: AgentResult\n  ): string {\n    const namespace = this.config.claudeFlow?.namespace ?? 'knowledge-graph';\n\n    switch (hookType) {\n      case 'pre-task':\n        return `claude-flow hooks pre-task --description \"${task.description}\"`;\n\n      case 'post-task':\n        return `claude-flow hooks post-task --task-id \"${task.id}\"`;\n\n      case 'post-edit':\n        return `claude-flow hooks post-edit --memory-key \"${namespace}/agent/${this.config.id}/task/${task.id}\"`;\n\n      default:\n        return '';\n    }\n  }\n\n  /**\n   * Store result in claude-flow memory\n   */\n  protected async storeInMemory(key: string, value: unknown): Promise<void> {\n    if (!this.config.claudeFlow?.enabled) {\n      return;\n    }\n\n    const namespace = this.config.claudeFlow.namespace ?? 'knowledge-graph';\n\n    this.logger.debug('Storing in claude-flow memory', { namespace, key });\n\n    // This would call the MCP memory_usage tool\n    // For now, just log the intent\n    this.logger.trace('Memory store', {\n      action: 'store',\n      namespace,\n      key,\n      value: JSON.stringify(value).slice(0, 100),\n    });\n  }\n}\n\n// ============================================================================\n// Helper Functions\n// ============================================================================\n\n/**\n * Create a task with defaults\n */\nexport function createTask(\n  description: string,\n  options?: Partial<Omit<AgentTask, 'id' | 'description' | 'createdAt'>>\n): AgentTask {\n  return {\n    id: createTaskId(),\n    description,\n    priority: options?.priority ?? TaskPriority.MEDIUM,\n    input: options?.input ?? {},\n    expectedOutput: options?.expectedOutput,\n    dependencies: options?.dependencies,\n    timeout: options?.timeout,\n    metadata: options?.metadata,\n    createdAt: new Date(),\n    deadline: options?.deadline,\n  };\n}\n\n/**\n * Type guard for checking if an object is an AgentResult\n */\nexport function isAgentResult(obj: unknown): obj is AgentResult {\n  return (\n    typeof obj === 'object' &&\n    obj !== null &&\n    'success' in obj &&\n    typeof (obj as AgentResult).success === 'boolean'\n  );\n}\n\n/**\n * Type guard for checking if an object is an AgentError\n */\nexport function isAgentError(obj: unknown): obj is AgentError {\n  return (\n    typeof obj === 'object' &&\n    obj !== null &&\n    'code' in obj &&\n    'message' in obj &&\n    typeof (obj as AgentError).code === 'string' &&\n    typeof (obj as AgentError).message === 'string'\n  );\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/commands/analyze.js

@@ -7,7 +7,7 @@ import { analyzeDocs } from "../../generators/docs-analyzer.js";
 import { validateProjectRoot } from "../../core/security.js";
 function createAnalyzeCommand() {
   const command = new Command("analyze");
-  command.description("Analyze and migrate docs to knowledge graph structure").option("-p, --path <path>", "Project root path", ".").option("-s, --source <dir>", "Source docs directory", "docs").option("-t, --target <dir>", "Target directory", "docs-nn").option("--use-claude-flow", "Use claude-flow for deep analysis").option("--no-moc", "Skip MOC (Map of Content) generation").option("--no-link-original", "Do not link back to original docs").option("--max-depth <n>", "Maximum analysis depth", "3").option("--dry-run", "Show what would be done without making changes").option("-v, --verbose", "Verbose output").action(async (options) => {
+  command.description("Analyze and migrate docs to knowledge graph structure").option("-p, --path <path>", "Project root path", ".").option("-s, --source <dir>", "Source docs directory", "docs").option("-t, --target <dir>", "Target directory", "docs").option("--use-claude-flow", "Use claude-flow for deep analysis").option("--no-moc", "Skip MOC (Map of Content) generation").option("--no-link-original", "Do not link back to original docs").option("--max-depth <n>", "Maximum analysis depth", "3").option("--dry-run", "Show what would be done without making changes").option("-v, --verbose", "Verbose output").action(async (options) => {
     const spinner = ora("Analyzing documentation...").start();
     try {
       const projectRoot = validateProjectRoot(options.path);
@@ -119,7 +119,7 @@ function createAnalyzeCommand() {
       process.exit(1);
     }
   });
-  command.command("deep").description("Deep analysis using claude-flow agents for comprehensive knowledge extraction").option("-p, --path <path>", "Project root path", ".").option("-s, --source <dir>", "Source docs directory", "docs").option("-t, --target <dir>", "Target directory", "docs-nn").option("--agents <n>", "Number of parallel agents", "3").action(async (options) => {
+  command.command("deep").description("Deep analysis using claude-flow agents for comprehensive knowledge extraction").option("-p, --path <path>", "Project root path", ".").option("-s, --source <dir>", "Source docs directory", "docs").option("-t, --target <dir>", "Target directory", "docs").option("--agents <n>", "Number of parallel agents", "3").action(async (options) => {
     const spinner = ora("Initializing deep analysis with claude-flow...").start();
     try {
       const projectRoot = validateProjectRoot(options.path);
@@ -184,7 +184,7 @@ function createAnalyzeCommand() {
       }
       const result = await analyzeDocs({
         sourceDir,
-        targetDir: "docs-nn",
+        targetDir: "docs",
         projectRoot,
         useClaudeFlow: false,
         createMOC: false,

package/dist/cli/commands/analyze.js.map

@@ -1 +1 @@
-{"version":3,"file":"analyze.js","sources":["../../../src/cli/commands/analyze.ts"],"sourcesContent":["/**\n * Analyze Command\n *\n * Advanced documentation analyzer using claude-flow for deep analysis\n * and creating proper knowledge graph documentation structure.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport { existsSync } from 'fs';\nimport { join } from 'path';\nimport { analyzeDocs } from '../../generators/docs-analyzer.js';\nimport { validateProjectRoot } from '../../core/security.js';\n\n/**\n * Create analyze command\n */\nexport function createAnalyzeCommand(): Command {\n  const command = new Command('analyze');\n\n  command\n    .description('Analyze and migrate docs to knowledge graph structure')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-s, --source <dir>', 'Source docs directory', 'docs')\n    .option('-t, --target <dir>', 'Target directory', 'docs-nn')\n    .option('--use-claude-flow', 'Use claude-flow for deep analysis')\n    .option('--no-moc', 'Skip MOC (Map of Content) generation')\n    .option('--no-link-original', 'Do not link back to original docs')\n    .option('--max-depth <n>', 'Maximum analysis depth', '3')\n    .option('--dry-run', 'Show what would be done without making changes')\n    .option('-v, --verbose', 'Verbose output')\n    .action(async (options) => {\n      const spinner = ora('Analyzing documentation...').start();\n\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n        const sourceDir = options.source;\n        const targetDir = options.target;\n\n        // Check source exists\n        if (!existsSync(join(projectRoot, sourceDir))) {\n          spinner.fail(`Source directory not found: ${sourceDir}`);\n          console.log(chalk.gray('  Specify source with --source <dir>'));\n          process.exit(1);\n        }\n\n        // Check if target already exists\n        if (existsSync(join(projectRoot, targetDir)) && !options.dryRun) {\n          spinner.warn(`Target directory exists: ${targetDir}`);\n          console.log(chalk.yellow('  Files may be overwritten. Use --dry-run to preview.'));\n        }\n\n        if (options.dryRun) {\n          spinner.text = 'Analyzing documentation (dry run)...';\n        }\n\n        if (options.useClaudeFlow) {\n          spinner.text = 'Analyzing with claude-flow (deep analysis)...';\n        }\n\n        const result = await analyzeDocs({\n          sourceDir,\n          targetDir,\n          projectRoot,\n          useClaudeFlow: options.useClaudeFlow,\n          createMOC: options.moc !== false,\n          linkOriginal: options.linkOriginal !== false,\n          maxDepth: parseInt(options.maxDepth, 10),\n          dryRun: options.dryRun,\n          verbose: options.verbose,\n        });\n\n        if (result.success) {\n          if (options.dryRun) {\n            spinner.succeed('Dry run complete!');\n          } else {\n            spinner.succeed('Documentation analyzed and migrated!');\n          }\n        } else {\n          spinner.warn('Analysis completed with errors');\n        }\n\n        // Display results\n        console.log();\n        console.log(chalk.cyan.bold('  Analysis Results'));\n        console.log(chalk.gray('  ─────────────────────────────────────'));\n        console.log();\n        console.log(chalk.white('  Summary:'));\n        console.log(chalk.gray(`    Source:          ${sourceDir}/`));\n        console.log(chalk.gray(`    Target:          ${targetDir}/`));\n        console.log(chalk.green(`    Files analyzed:  ${result.filesAnalyzed}`));\n        console.log(chalk.green(`    Files created:   ${result.filesCreated}`));\n        console.log(chalk.blue(`    MOC files:       ${result.mocFilesCreated}`));\n\n        // Category breakdown\n        if (result.structure.size > 0) {\n          console.log();\n          console.log(chalk.white('  Categories:'));\n          for (const [category, docs] of result.structure) {\n            console.log(chalk.cyan(`    ${category.padEnd(15)}`), chalk.gray(`${docs.length} docs`));\n          }\n        }\n\n        // Show sample analyzed documents\n        if (result.analyzed.length > 0 && options.verbose) {\n          console.log();\n          console.log(chalk.white('  Sample documents:'));\n          result.analyzed.slice(0, 5).forEach(doc => {\n            console.log(chalk.gray(`    ${doc.originalPath}`));\n            console.log(chalk.cyan(`      → ${doc.newPath}`) + chalk.gray(` [${doc.type}]`));\n            if (doc.tags.length > 0) {\n              console.log(chalk.gray(`        tags: ${doc.tags.slice(0, 5).map(t => `#${t}`).join(' ')}`));\n            }\n          });\n          if (result.analyzed.length > 5) {\n            console.log(chalk.gray(`    ... and ${result.analyzed.length - 5} more`));\n          }\n        }\n\n        // Show errors\n        if (result.errors.length > 0) {\n          console.log();\n          console.log(chalk.red('  Errors:'));\n          result.errors.slice(0, 5).forEach(err => {\n            console.log(chalk.gray(`    - ${err}`));\n          });\n          if (result.errors.length > 5) {\n            console.log(chalk.gray(`    ... and ${result.errors.length - 5} more`));\n          }\n        }\n\n        // Research needed summary\n        const researchDocs = result.analyzed.filter(d => d.researchNeeded.length > 0);\n        const todoDocs = result.analyzed.filter(d => d.todos.length > 0);\n\n        if (researchDocs.length > 0 || todoDocs.length > 0) {\n          console.log();\n          console.log(chalk.yellow('  Attention Needed:'));\n          if (researchDocs.length > 0) {\n            console.log(chalk.yellow(`    📚 ${researchDocs.length} docs need research`));\n          }\n          if (todoDocs.length > 0) {\n            console.log(chalk.yellow(`    ✏️  ${todoDocs.length} docs have TODOs`));\n          }\n        }\n\n        // Next steps\n        if (!options.dryRun && result.filesCreated > 0) {\n          console.log();\n          console.log(chalk.cyan('  Next steps:'));\n          console.log(chalk.white(`    1. Review ${targetDir}/MOC.md (Master Index)`));\n          console.log(chalk.white(`    2. Check ${targetDir}/PRIMITIVES.md`));\n          console.log(chalk.white(`    3. Run: kg graph --docs ${targetDir}`));\n          console.log(chalk.white(`    4. Run: kg stats --docs ${targetDir}`));\n          if (researchDocs.length > 0) {\n            console.log(chalk.white(`    5. Address research items in flagged docs`));\n          }\n        }\n\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Analysis failed');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  // Deep analyze subcommand (uses claude-flow agents)\n  command\n    .command('deep')\n    .description('Deep analysis using claude-flow agents for comprehensive knowledge extraction')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-s, --source <dir>', 'Source docs directory', 'docs')\n    .option('-t, --target <dir>', 'Target directory', 'docs-nn')\n    .option('--agents <n>', 'Number of parallel agents', '3')\n    .action(async (options) => {\n      const spinner = ora('Initializing deep analysis with claude-flow...').start();\n\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n        const sourceDir = options.source;\n        const targetDir = options.target;\n\n        // Check source exists\n        if (!existsSync(join(projectRoot, sourceDir))) {\n          spinner.fail(`Source directory not found: ${sourceDir}`);\n          process.exit(1);\n        }\n\n        spinner.text = 'Running claude-flow deep analysis...';\n\n        // Run deep analysis with claude-flow\n        const result = await analyzeDocs({\n          sourceDir,\n          targetDir,\n          projectRoot,\n          useClaudeFlow: true,\n          createMOC: true,\n          linkOriginal: true,\n          maxDepth: 5,\n          dryRun: false,\n          verbose: true,\n        });\n\n        if (result.success) {\n          spinner.succeed('Deep analysis complete!');\n        } else {\n          spinner.warn('Deep analysis completed with some errors');\n        }\n\n        console.log();\n        console.log(chalk.cyan.bold('  Deep Analysis Results'));\n        console.log(chalk.gray('  ─────────────────────────────────────'));\n        console.log(chalk.green(`    Documents analyzed:  ${result.filesAnalyzed}`));\n        console.log(chalk.green(`    Knowledge docs:      ${result.filesCreated}`));\n        console.log(chalk.blue(`    Index files (MOC):   ${result.mocFilesCreated}`));\n        console.log(chalk.gray(`    Categories:          ${result.structure.size}`));\n\n        // Research summary\n        const totalResearch = result.analyzed.reduce((sum, d) => sum + d.researchNeeded.length, 0);\n        const totalTodos = result.analyzed.reduce((sum, d) => sum + d.todos.length, 0);\n\n        console.log();\n        console.log(chalk.white('  Knowledge extraction:'));\n        console.log(chalk.cyan(`    Research areas:  ${totalResearch}`));\n        console.log(chalk.cyan(`    TODOs found:     ${totalTodos}`));\n        console.log(chalk.cyan(`    Concepts:        ${result.analyzed.reduce((sum, d) => sum + d.concepts.length, 0)}`));\n        console.log(chalk.cyan(`    Cross-refs:      ${result.analyzed.reduce((sum, d) => sum + d.related.length, 0)}`));\n\n        console.log();\n        console.log(chalk.white(`  Output: ${targetDir}/`));\n        console.log(chalk.gray(`    MOC.md           Master index`));\n        console.log(chalk.gray(`    PRIMITIVES.md    Core building blocks`));\n        console.log(chalk.gray(`    */\\_MOC.md        Category indexes`));\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Deep analysis failed');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  // Report subcommand\n  command\n    .command('report')\n    .description('Generate analysis report without creating files')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-s, --source <dir>', 'Source docs directory', 'docs')\n    .option('--json', 'Output as JSON')\n    .action(async (options) => {\n      const spinner = ora('Generating analysis report...').start();\n\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n        const sourceDir = options.source;\n\n        if (!existsSync(join(projectRoot, sourceDir))) {\n          spinner.fail(`Source directory not found: ${sourceDir}`);\n          process.exit(1);\n        }\n\n        const result = await analyzeDocs({\n          sourceDir,\n          targetDir: 'docs-nn',\n          projectRoot,\n          useClaudeFlow: false,\n          createMOC: false,\n          linkOriginal: false,\n          dryRun: true,\n          verbose: false,\n        });\n\n        spinner.succeed('Report generated!');\n\n        if (options.json) {\n          // JSON output\n          const report = {\n            summary: {\n              totalDocs: result.filesAnalyzed,\n              categories: Object.fromEntries(result.structure),\n            },\n            documents: result.analyzed.map(d => ({\n              original: d.originalPath,\n              target: d.newPath,\n              type: d.type,\n              category: d.category,\n              tags: d.tags,\n              concepts: d.concepts,\n              researchNeeded: d.researchNeeded,\n              todos: d.todos,\n            })),\n            researchAreas: result.analyzed\n              .flatMap(d => d.researchNeeded.map(r => ({ doc: d.title, area: r }))),\n            todos: result.analyzed\n              .flatMap(d => d.todos.map(t => ({ doc: d.title, todo: t }))),\n          };\n          console.log(JSON.stringify(report, null, 2));\n        } else {\n          // Human-readable output\n          console.log();\n          console.log(chalk.cyan.bold('  Documentation Analysis Report'));\n          console.log(chalk.gray('  ─────────────────────────────────────'));\n          console.log();\n          console.log(chalk.white(`  Total documents: ${result.filesAnalyzed}`));\n          console.log();\n\n          // Type breakdown\n          const byType = new Map<string, number>();\n          result.analyzed.forEach(d => {\n            byType.set(d.type, (byType.get(d.type) || 0) + 1);\n          });\n\n          console.log(chalk.white('  By Type:'));\n          for (const [type, count] of byType) {\n            const bar = '█'.repeat(Math.ceil(count / result.filesAnalyzed * 20));\n            console.log(chalk.cyan(`    ${type.padEnd(12)} ${bar} ${count}`));\n          }\n          console.log();\n\n          // Category breakdown\n          console.log(chalk.white('  By Category:'));\n          for (const [category, docs] of result.structure) {\n            const bar = '█'.repeat(Math.ceil(docs.length / result.filesAnalyzed * 20));\n            console.log(chalk.cyan(`    ${category.padEnd(12)} ${bar} ${docs.length}`));\n          }\n          console.log();\n\n          // Issues\n          const withResearch = result.analyzed.filter(d => d.researchNeeded.length > 0);\n          const withTodos = result.analyzed.filter(d => d.todos.length > 0);\n\n          console.log(chalk.white('  Areas Needing Attention:'));\n          console.log(chalk.yellow(`    📚 Research needed:   ${withResearch.length} docs`));\n          console.log(chalk.yellow(`    ✏️  With TODOs:        ${withTodos.length} docs`));\n          console.log();\n\n          // Top research areas\n          if (withResearch.length > 0) {\n            console.log(chalk.white('  Top Research Areas:'));\n            withResearch.slice(0, 5).forEach(d => {\n              console.log(chalk.gray(`    ${d.title}:`));\n              d.researchNeeded.slice(0, 2).forEach(r => {\n                console.log(chalk.yellow(`      - ${r.slice(0, 60)}...`));\n              });\n            });\n            console.log();\n          }\n\n          console.log(chalk.cyan('  Run `kg analyze` to migrate documentation'));\n          console.log();\n        }\n\n      } catch (error) {\n        spinner.fail('Report generation failed');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  return command;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"analyze.js","sources":["../../../src/cli/commands/analyze.ts"],"sourcesContent":["/**\n * Analyze Command\n *\n * Advanced documentation analyzer using claude-flow for deep analysis\n * and creating proper knowledge graph documentation structure.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport { existsSync } from 'fs';\nimport { join } from 'path';\nimport { analyzeDocs } from '../../generators/docs-analyzer.js';\nimport { validateProjectRoot } from '../../core/security.js';\n\n/**\n * Create analyze command\n */\nexport function createAnalyzeCommand(): Command {\n  const command = new Command('analyze');\n\n  command\n    .description('Analyze and migrate docs to knowledge graph structure')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-s, --source <dir>', 'Source docs directory', 'docs')\n    .option('-t, --target <dir>', 'Target directory', 'docs')\n    .option('--use-claude-flow', 'Use claude-flow for deep analysis')\n    .option('--no-moc', 'Skip MOC (Map of Content) generation')\n    .option('--no-link-original', 'Do not link back to original docs')\n    .option('--max-depth <n>', 'Maximum analysis depth', '3')\n    .option('--dry-run', 'Show what would be done without making changes')\n    .option('-v, --verbose', 'Verbose output')\n    .action(async (options) => {\n      const spinner = ora('Analyzing documentation...').start();\n\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n        const sourceDir = options.source;\n        const targetDir = options.target;\n\n        // Check source exists\n        if (!existsSync(join(projectRoot, sourceDir))) {\n          spinner.fail(`Source directory not found: ${sourceDir}`);\n          console.log(chalk.gray('  Specify source with --source <dir>'));\n          process.exit(1);\n        }\n\n        // Check if target already exists\n        if (existsSync(join(projectRoot, targetDir)) && !options.dryRun) {\n          spinner.warn(`Target directory exists: ${targetDir}`);\n          console.log(chalk.yellow('  Files may be overwritten. Use --dry-run to preview.'));\n        }\n\n        if (options.dryRun) {\n          spinner.text = 'Analyzing documentation (dry run)...';\n        }\n\n        if (options.useClaudeFlow) {\n          spinner.text = 'Analyzing with claude-flow (deep analysis)...';\n        }\n\n        const result = await analyzeDocs({\n          sourceDir,\n          targetDir,\n          projectRoot,\n          useClaudeFlow: options.useClaudeFlow,\n          createMOC: options.moc !== false,\n          linkOriginal: options.linkOriginal !== false,\n          maxDepth: parseInt(options.maxDepth, 10),\n          dryRun: options.dryRun,\n          verbose: options.verbose,\n        });\n\n        if (result.success) {\n          if (options.dryRun) {\n            spinner.succeed('Dry run complete!');\n          } else {\n            spinner.succeed('Documentation analyzed and migrated!');\n          }\n        } else {\n          spinner.warn('Analysis completed with errors');\n        }\n\n        // Display results\n        console.log();\n        console.log(chalk.cyan.bold('  Analysis Results'));\n        console.log(chalk.gray('  ─────────────────────────────────────'));\n        console.log();\n        console.log(chalk.white('  Summary:'));\n        console.log(chalk.gray(`    Source:          ${sourceDir}/`));\n        console.log(chalk.gray(`    Target:          ${targetDir}/`));\n        console.log(chalk.green(`    Files analyzed:  ${result.filesAnalyzed}`));\n        console.log(chalk.green(`    Files created:   ${result.filesCreated}`));\n        console.log(chalk.blue(`    MOC files:       ${result.mocFilesCreated}`));\n\n        // Category breakdown\n        if (result.structure.size > 0) {\n          console.log();\n          console.log(chalk.white('  Categories:'));\n          for (const [category, docs] of result.structure) {\n            console.log(chalk.cyan(`    ${category.padEnd(15)}`), chalk.gray(`${docs.length} docs`));\n          }\n        }\n\n        // Show sample analyzed documents\n        if (result.analyzed.length > 0 && options.verbose) {\n          console.log();\n          console.log(chalk.white('  Sample documents:'));\n          result.analyzed.slice(0, 5).forEach(doc => {\n            console.log(chalk.gray(`    ${doc.originalPath}`));\n            console.log(chalk.cyan(`      → ${doc.newPath}`) + chalk.gray(` [${doc.type}]`));\n            if (doc.tags.length > 0) {\n              console.log(chalk.gray(`        tags: ${doc.tags.slice(0, 5).map(t => `#${t}`).join(' ')}`));\n            }\n          });\n          if (result.analyzed.length > 5) {\n            console.log(chalk.gray(`    ... and ${result.analyzed.length - 5} more`));\n          }\n        }\n\n        // Show errors\n        if (result.errors.length > 0) {\n          console.log();\n          console.log(chalk.red('  Errors:'));\n          result.errors.slice(0, 5).forEach(err => {\n            console.log(chalk.gray(`    - ${err}`));\n          });\n          if (result.errors.length > 5) {\n            console.log(chalk.gray(`    ... and ${result.errors.length - 5} more`));\n          }\n        }\n\n        // Research needed summary\n        const researchDocs = result.analyzed.filter(d => d.researchNeeded.length > 0);\n        const todoDocs = result.analyzed.filter(d => d.todos.length > 0);\n\n        if (researchDocs.length > 0 || todoDocs.length > 0) {\n          console.log();\n          console.log(chalk.yellow('  Attention Needed:'));\n          if (researchDocs.length > 0) {\n            console.log(chalk.yellow(`    📚 ${researchDocs.length} docs need research`));\n          }\n          if (todoDocs.length > 0) {\n            console.log(chalk.yellow(`    ✏️  ${todoDocs.length} docs have TODOs`));\n          }\n        }\n\n        // Next steps\n        if (!options.dryRun && result.filesCreated > 0) {\n          console.log();\n          console.log(chalk.cyan('  Next steps:'));\n          console.log(chalk.white(`    1. Review ${targetDir}/MOC.md (Master Index)`));\n          console.log(chalk.white(`    2. Check ${targetDir}/PRIMITIVES.md`));\n          console.log(chalk.white(`    3. Run: kg graph --docs ${targetDir}`));\n          console.log(chalk.white(`    4. Run: kg stats --docs ${targetDir}`));\n          if (researchDocs.length > 0) {\n            console.log(chalk.white(`    5. Address research items in flagged docs`));\n          }\n        }\n\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Analysis failed');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  // Deep analyze subcommand (uses claude-flow agents)\n  command\n    .command('deep')\n    .description('Deep analysis using claude-flow agents for comprehensive knowledge extraction')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-s, --source <dir>', 'Source docs directory', 'docs')\n    .option('-t, --target <dir>', 'Target directory', 'docs')\n    .option('--agents <n>', 'Number of parallel agents', '3')\n    .action(async (options) => {\n      const spinner = ora('Initializing deep analysis with claude-flow...').start();\n\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n        const sourceDir = options.source;\n        const targetDir = options.target;\n\n        // Check source exists\n        if (!existsSync(join(projectRoot, sourceDir))) {\n          spinner.fail(`Source directory not found: ${sourceDir}`);\n          process.exit(1);\n        }\n\n        spinner.text = 'Running claude-flow deep analysis...';\n\n        // Run deep analysis with claude-flow\n        const result = await analyzeDocs({\n          sourceDir,\n          targetDir,\n          projectRoot,\n          useClaudeFlow: true,\n          createMOC: true,\n          linkOriginal: true,\n          maxDepth: 5,\n          dryRun: false,\n          verbose: true,\n        });\n\n        if (result.success) {\n          spinner.succeed('Deep analysis complete!');\n        } else {\n          spinner.warn('Deep analysis completed with some errors');\n        }\n\n        console.log();\n        console.log(chalk.cyan.bold('  Deep Analysis Results'));\n        console.log(chalk.gray('  ─────────────────────────────────────'));\n        console.log(chalk.green(`    Documents analyzed:  ${result.filesAnalyzed}`));\n        console.log(chalk.green(`    Knowledge docs:      ${result.filesCreated}`));\n        console.log(chalk.blue(`    Index files (MOC):   ${result.mocFilesCreated}`));\n        console.log(chalk.gray(`    Categories:          ${result.structure.size}`));\n\n        // Research summary\n        const totalResearch = result.analyzed.reduce((sum, d) => sum + d.researchNeeded.length, 0);\n        const totalTodos = result.analyzed.reduce((sum, d) => sum + d.todos.length, 0);\n\n        console.log();\n        console.log(chalk.white('  Knowledge extraction:'));\n        console.log(chalk.cyan(`    Research areas:  ${totalResearch}`));\n        console.log(chalk.cyan(`    TODOs found:     ${totalTodos}`));\n        console.log(chalk.cyan(`    Concepts:        ${result.analyzed.reduce((sum, d) => sum + d.concepts.length, 0)}`));\n        console.log(chalk.cyan(`    Cross-refs:      ${result.analyzed.reduce((sum, d) => sum + d.related.length, 0)}`));\n\n        console.log();\n        console.log(chalk.white(`  Output: ${targetDir}/`));\n        console.log(chalk.gray(`    MOC.md           Master index`));\n        console.log(chalk.gray(`    PRIMITIVES.md    Core building blocks`));\n        console.log(chalk.gray(`    */\\_MOC.md        Category indexes`));\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Deep analysis failed');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  // Report subcommand\n  command\n    .command('report')\n    .description('Generate analysis report without creating files')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-s, --source <dir>', 'Source docs directory', 'docs')\n    .option('--json', 'Output as JSON')\n    .action(async (options) => {\n      const spinner = ora('Generating analysis report...').start();\n\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n        const sourceDir = options.source;\n\n        if (!existsSync(join(projectRoot, sourceDir))) {\n          spinner.fail(`Source directory not found: ${sourceDir}`);\n          process.exit(1);\n        }\n\n        const result = await analyzeDocs({\n          sourceDir,\n          targetDir: 'docs',\n          projectRoot,\n          useClaudeFlow: false,\n          createMOC: false,\n          linkOriginal: false,\n          dryRun: true,\n          verbose: false,\n        });\n\n        spinner.succeed('Report generated!');\n\n        if (options.json) {\n          // JSON output\n          const report = {\n            summary: {\n              totalDocs: result.filesAnalyzed,\n              categories: Object.fromEntries(result.structure),\n            },\n            documents: result.analyzed.map(d => ({\n              original: d.originalPath,\n              target: d.newPath,\n              type: d.type,\n              category: d.category,\n              tags: d.tags,\n              concepts: d.concepts,\n              researchNeeded: d.researchNeeded,\n              todos: d.todos,\n            })),\n            researchAreas: result.analyzed\n              .flatMap(d => d.researchNeeded.map(r => ({ doc: d.title, area: r }))),\n            todos: result.analyzed\n              .flatMap(d => d.todos.map(t => ({ doc: d.title, todo: t }))),\n          };\n          console.log(JSON.stringify(report, null, 2));\n        } else {\n          // Human-readable output\n          console.log();\n          console.log(chalk.cyan.bold('  Documentation Analysis Report'));\n          console.log(chalk.gray('  ─────────────────────────────────────'));\n          console.log();\n          console.log(chalk.white(`  Total documents: ${result.filesAnalyzed}`));\n          console.log();\n\n          // Type breakdown\n          const byType = new Map<string, number>();\n          result.analyzed.forEach(d => {\n            byType.set(d.type, (byType.get(d.type) || 0) + 1);\n          });\n\n          console.log(chalk.white('  By Type:'));\n          for (const [type, count] of byType) {\n            const bar = '█'.repeat(Math.ceil(count / result.filesAnalyzed * 20));\n            console.log(chalk.cyan(`    ${type.padEnd(12)} ${bar} ${count}`));\n          }\n          console.log();\n\n          // Category breakdown\n          console.log(chalk.white('  By Category:'));\n          for (const [category, docs] of result.structure) {\n            const bar = '█'.repeat(Math.ceil(docs.length / result.filesAnalyzed * 20));\n            console.log(chalk.cyan(`    ${category.padEnd(12)} ${bar} ${docs.length}`));\n          }\n          console.log();\n\n          // Issues\n          const withResearch = result.analyzed.filter(d => d.researchNeeded.length > 0);\n          const withTodos = result.analyzed.filter(d => d.todos.length > 0);\n\n          console.log(chalk.white('  Areas Needing Attention:'));\n          console.log(chalk.yellow(`    📚 Research needed:   ${withResearch.length} docs`));\n          console.log(chalk.yellow(`    ✏️  With TODOs:        ${withTodos.length} docs`));\n          console.log();\n\n          // Top research areas\n          if (withResearch.length > 0) {\n            console.log(chalk.white('  Top Research Areas:'));\n            withResearch.slice(0, 5).forEach(d => {\n              console.log(chalk.gray(`    ${d.title}:`));\n              d.researchNeeded.slice(0, 2).forEach(r => {\n                console.log(chalk.yellow(`      - ${r.slice(0, 60)}...`));\n              });\n            });\n            console.log();\n          }\n\n          console.log(chalk.cyan('  Run `kg analyze` to migrate documentation'));\n          console.log();\n        }\n\n      } catch (error) {\n        spinner.fail('Report generation failed');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  return command;\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/commands/convert.js

@@ -8,7 +8,7 @@ import { validateProjectRoot } from "../../core/security.js";
 function createConvertCommand() {
   const command = new Command("convert");
   command.description("Convert existing docs to weave-nn structure");
-  command.command("docs").description("Convert existing documentation to docs-nn/ with proper structure").option("-p, --path <path>", "Project root path", ".").option("-s, --source <dir>", "Source docs directory", "docs").option("-t, --target <dir>", "Target directory", "docs-nn").option("--no-auto-category", "Disable auto-categorization").option("-f, --force", "Overwrite existing files").option("--dry-run", "Show what would be done without making changes").action(async (options) => {
+  command.command("docs").description("Convert existing documentation with proper structure").option("-p, --path <path>", "Project root path", ".").option("-s, --source <dir>", "Source docs directory", "docs").option("-t, --target <dir>", "Target directory", "docs").option("--no-auto-category", "Disable auto-categorization").option("-f, --force", "Overwrite existing files").option("--dry-run", "Show what would be done without making changes").action(async (options) => {
     const spinner = ora("Converting documentation...").start();
     try {
       const projectRoot = validateProjectRoot(options.path);

package/dist/cli/commands/convert.js.map

@@ -1 +1 @@
-{"version":3,"file":"convert.js","sources":["../../../src/cli/commands/convert.ts"],"sourcesContent":["/**\n * Convert Command\n *\n * Convert existing documentation to weave-nn structure.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport { existsSync } from 'fs';\nimport { join } from 'path';\nimport {\n  convertDocs,\n  addFrontmatter,\n  validateFrontmatter,\n} from '../../generators/docs-convert.js';\nimport { validateProjectRoot, validateDocsPath } from '../../core/security.js';\n\n/**\n * Create convert command\n */\nexport function createConvertCommand(): Command {\n  const command = new Command('convert');\n\n  command\n    .description('Convert existing docs to weave-nn structure');\n\n  // Main convert subcommand\n  command\n    .command('docs')\n    .description('Convert existing documentation to docs-nn/ with proper structure')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-s, --source <dir>', 'Source docs directory', 'docs')\n    .option('-t, --target <dir>', 'Target directory', 'docs-nn')\n    .option('--no-auto-category', 'Disable auto-categorization')\n    .option('-f, --force', 'Overwrite existing files')\n    .option('--dry-run', 'Show what would be done without making changes')\n    .action(async (options) => {\n      const spinner = ora('Converting documentation...').start();\n\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n        const sourceDir = options.source;\n        const targetDir = options.target;\n\n        // Check source exists\n        if (!existsSync(join(projectRoot, sourceDir))) {\n          spinner.fail(`Source directory not found: ${sourceDir}`);\n          console.log(chalk.gray('  Specify source with --source <dir>'));\n          process.exit(1);\n        }\n\n        if (options.dryRun) {\n          spinner.text = 'Analyzing documentation (dry run)...';\n        }\n\n        const result = await convertDocs({\n          sourceDir,\n          targetDir,\n          projectRoot,\n          preserveOriginal: true,\n          force: options.force,\n          autoCategory: options.autoCategory !== false,\n          dryRun: options.dryRun,\n        });\n\n        if (result.success) {\n          if (options.dryRun) {\n            spinner.succeed('Dry run complete!');\n          } else {\n            spinner.succeed('Documentation converted!');\n          }\n        } else {\n          spinner.warn('Conversion completed with errors');\n        }\n\n        console.log();\n        console.log(chalk.white('  Summary:'));\n        console.log(chalk.gray(`    Source:      ${sourceDir}/`));\n        console.log(chalk.gray(`    Target:      ${targetDir}/`));\n        console.log(chalk.green(`    Converted:   ${result.filesConverted}`));\n        console.log(chalk.yellow(`    Skipped:     ${result.filesSkipped}`));\n        console.log(chalk.gray(`    Total:       ${result.filesProcessed}`));\n\n        if (result.converted.length > 0 && result.converted.length <= 10) {\n          console.log();\n          console.log(chalk.white('  Converted files:'));\n          result.converted.forEach(({ source, target, type }) => {\n            console.log(chalk.gray(`    ${source}`));\n            console.log(chalk.cyan(`      → ${target}`) + chalk.gray(` [${type}]`));\n          });\n        } else if (result.converted.length > 10) {\n          console.log();\n          console.log(chalk.white('  Sample conversions:'));\n          result.converted.slice(0, 5).forEach(({ source, target, type }) => {\n            console.log(chalk.gray(`    ${source}`));\n            console.log(chalk.cyan(`      → ${target}`) + chalk.gray(` [${type}]`));\n          });\n          console.log(chalk.gray(`    ... and ${result.converted.length - 5} more`));\n        }\n\n        if (result.errors.length > 0) {\n          console.log();\n          console.log(chalk.red('  Errors:'));\n          result.errors.slice(0, 5).forEach(err => {\n            console.log(chalk.gray(`    - ${err}`));\n          });\n          if (result.errors.length > 5) {\n            console.log(chalk.gray(`    ... and ${result.errors.length - 5} more`));\n          }\n        }\n\n        if (!options.dryRun && result.filesConverted > 0) {\n          console.log();\n          console.log(chalk.cyan('Next steps:'));\n          console.log(chalk.white(`  1. Review ${targetDir}/ structure`));\n          console.log(chalk.white('  2. Run: kg graph --docs ' + targetDir));\n          console.log(chalk.white('  3. Run: kg stats'));\n        }\n\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Conversion failed');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  return command;\n}\n\n/**\n * Create frontmatter command\n */\nexport function createFrontmatterCommand(): Command {\n  const command = new Command('frontmatter');\n\n  command\n    .description('Manage frontmatter in markdown files');\n\n  // Add frontmatter\n  command\n    .command('add [target]')\n    .description('Add frontmatter to files missing it')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-t, --type <type>', 'Node type (concept, technical, feature, service, guide, standard, integration)')\n    .option('-s, --status <status>', 'Status (draft, active, deprecated, archived)', 'active')\n    .option('--tags <tags>', 'Comma-separated tags')\n    .option('-f, --force', 'Overwrite existing frontmatter')\n    .option('--dry-run', 'Show what would be done')\n    .action(async (target, options) => {\n      const spinner = ora('Adding frontmatter...').start();\n\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n        const targetPath = target || 'docs';\n\n        const tags = options.tags ? options.tags.split(',').map((t: string) => t.trim()) : [];\n\n        const result = await addFrontmatter({\n          target: targetPath,\n          projectRoot,\n          type: options.type,\n          status: options.status,\n          tags,\n          force: options.force,\n          dryRun: options.dryRun,\n        });\n\n        if (result.success) {\n          spinner.succeed(options.dryRun ? 'Dry run complete!' : 'Frontmatter added!');\n        } else {\n          spinner.warn('Completed with errors');\n        }\n\n        console.log();\n        console.log(chalk.white('  Summary:'));\n        console.log(chalk.green(`    Updated:  ${result.filesUpdated}`));\n        console.log(chalk.yellow(`    Skipped:  ${result.filesSkipped}`));\n        console.log(chalk.gray(`    Total:    ${result.filesProcessed}`));\n\n        if (result.errors.length > 0) {\n          console.log();\n          console.log(chalk.red('  Errors:'));\n          result.errors.forEach(err => {\n            console.log(chalk.gray(`    - ${err}`));\n          });\n        }\n\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Failed to add frontmatter');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  // Validate frontmatter\n  command\n    .command('validate [target]')\n    .description('Validate frontmatter in markdown files')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .action(async (target, options) => {\n      const spinner = ora('Validating frontmatter...').start();\n\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n        const targetPath = target || 'docs';\n\n        const result = await validateFrontmatter(targetPath, projectRoot);\n\n        spinner.succeed('Validation complete!');\n\n        console.log();\n        console.log(chalk.white('  Frontmatter Validation:'));\n        console.log(chalk.green(`    Valid:    ${result.valid}`));\n        console.log(chalk.red(`    Invalid:  ${result.invalid}`));\n        console.log(chalk.yellow(`    Missing:  ${result.missing}`));\n\n        if (result.issues.length > 0) {\n          console.log();\n          console.log(chalk.yellow('  Issues found:'));\n          result.issues.slice(0, 10).forEach(({ file, issues }) => {\n            console.log(chalk.white(`    ${file}`));\n            issues.forEach(issue => {\n              console.log(chalk.gray(`      - ${issue}`));\n            });\n          });\n          if (result.issues.length > 10) {\n            console.log(chalk.gray(`    ... and ${result.issues.length - 10} more files`));\n          }\n\n          console.log();\n          console.log(chalk.cyan('Fix with: ') + chalk.white('kg frontmatter add <target>'));\n        }\n\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Validation failed');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  // Update frontmatter (force mode)\n  command\n    .command('update [target]')\n    .description('Update/regenerate frontmatter (overwrites existing)')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-t, --type <type>', 'Force specific node type')\n    .option('--dry-run', 'Show what would be done')\n    .action(async (target, options) => {\n      const spinner = ora('Updating frontmatter...').start();\n\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n        const targetPath = target || 'docs';\n\n        const result = await addFrontmatter({\n          target: targetPath,\n          projectRoot,\n          type: options.type,\n          force: true,\n          dryRun: options.dryRun,\n        });\n\n        if (result.success) {\n          spinner.succeed(options.dryRun ? 'Dry run complete!' : 'Frontmatter updated!');\n        } else {\n          spinner.warn('Completed with errors');\n        }\n\n        console.log();\n        console.log(chalk.green(`  Updated: ${result.filesUpdated} files`));\n\n        if (result.errors.length > 0) {\n          console.log(chalk.red(`  Errors: ${result.errors.length}`));\n        }\n\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Failed to update frontmatter');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  return command;\n}\n"],"names":[],"mappings":";;;;;;;AAqBO,SAAS,uBAAgC;AAC9C,QAAM,UAAU,IAAI,QAAQ,SAAS;AAErC,UACG,YAAY,6CAA6C;AAG5D,UACG,QAAQ,MAAM,EACd,YAAY,kEAAkE,EAC9E,OAAO,qBAAqB,qBAAqB,GAAG,EACpD,OAAO,sBAAsB,yBAAyB,MAAM,EAC5D,OAAO,sBAAsB,oBAAoB,SAAS,EAC1D,OAAO,sBAAsB,6BAA6B,EAC1D,OAAO,eAAe,0BAA0B,EAChD,OAAO,aAAa,gDAAgD,EACpE,OAAO,OAAO,YAAY;AACzB,UAAM,UAAU,IAAI,6BAA6B,EAAE,MAAA;AAEnD,QAAI;AACF,YAAM,cAAc,oBAAoB,QAAQ,IAAI;AACpD,YAAM,YAAY,QAAQ;AAC1B,YAAM,YAAY,QAAQ;AAG1B,UAAI,CAAC,WAAW,KAAK,aAAa,SAAS,CAAC,GAAG;AAC7C,gBAAQ,KAAK,+BAA+B,SAAS,EAAE;AACvD,gBAAQ,IAAI,MAAM,KAAK,sCAAsC,CAAC;AAC9D,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAEA,UAAI,QAAQ,QAAQ;AAClB,gBAAQ,OAAO;AAAA,MACjB;AAEA,YAAM,SAAS,MAAM,YAAY;AAAA,QAC/B;AAAA,QACA;AAAA,QACA;AAAA,QACA,kBAAkB;AAAA,QAClB,OAAO,QAAQ;AAAA,QACf,cAAc,QAAQ,iBAAiB;AAAA,QACvC,QAAQ,QAAQ;AAAA,MAAA,CACjB;AAED,UAAI,OAAO,SAAS;AAClB,YAAI,QAAQ,QAAQ;AAClB,kBAAQ,QAAQ,mBAAmB;AAAA,QACrC,OAAO;AACL,kBAAQ,QAAQ,0BAA0B;AAAA,QAC5C;AAAA,MACF,OAAO;AACL,gBAAQ,KAAK,kCAAkC;AAAA,MACjD;AAEA,cAAQ,IAAA;AACR,cAAQ,IAAI,MAAM,MAAM,YAAY,CAAC;AACrC,cAAQ,IAAI,MAAM,KAAK,oBAAoB,SAAS,GAAG,CAAC;AACxD,cAAQ,IAAI,MAAM,KAAK,oBAAoB,SAAS,GAAG,CAAC;AACxD,cAAQ,IAAI,MAAM,MAAM,oBAAoB,OAAO,cAAc,EAAE,CAAC;AACpE,cAAQ,IAAI,MAAM,OAAO,oBAAoB,OAAO,YAAY,EAAE,CAAC;AACnE,cAAQ,IAAI,MAAM,KAAK,oBAAoB,OAAO,cAAc,EAAE,CAAC;AAEnE,UAAI,OAAO,UAAU,SAAS,KAAK,OAAO,UAAU,UAAU,IAAI;AAChE,gBAAQ,IAAA;AACR,gBAAQ,IAAI,MAAM,MAAM,oBAAoB,CAAC;AAC7C,eAAO,UAAU,QAAQ,CAAC,EAAE,QAAQ,QAAQ,WAAW;AACrD,kBAAQ,IAAI,MAAM,KAAK,OAAO,MAAM,EAAE,CAAC;AACvC,kBAAQ,IAAI,MAAM,KAAK,WAAW,MAAM,EAAE,IAAI,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC;AAAA,QACxE,CAAC;AAAA,MACH,WAAW,OAAO,UAAU,SAAS,IAAI;AACvC,gBAAQ,IAAA;AACR,gBAAQ,IAAI,MAAM,MAAM,uBAAuB,CAAC;AAChD,eAAO,UAAU,MAAM,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,QAAQ,QAAQ,KAAA,MAAW;AACjE,kBAAQ,IAAI,MAAM,KAAK,OAAO,MAAM,EAAE,CAAC;AACvC,kBAAQ,IAAI,MAAM,KAAK,WAAW,MAAM,EAAE,IAAI,MAAM,KAAK,KAAK,IAAI,GAAG,CAAC;AAAA,QACxE,CAAC;AACD,gBAAQ,IAAI,MAAM,KAAK,eAAe,OAAO,UAAU,SAAS,CAAC,OAAO,CAAC;AAAA,MAC3E;AAEA,UAAI,OAAO,OAAO,SAAS,GAAG;AAC5B,gBAAQ,IAAA;AACR,gBAAQ,IAAI,MAAM,IAAI,WAAW,CAAC;AAClC,eAAO,OAAO,MAAM,GAAG,CAAC,EAAE,QAAQ,CAAA,QAAO;AACvC,kBAAQ,IAAI,MAAM,KAAK,SAAS,GAAG,EAAE,CAAC;AAAA,QACxC,CAAC;AACD,YAAI,OAAO,OAAO,SAAS,GAAG;AAC5B,kBAAQ,IAAI,MAAM,KAAK,eAAe,OAAO,OAAO,SAAS,CAAC,OAAO,CAAC;AAAA,QACxE;AAAA,MACF;AAEA,UAAI,CAAC,QAAQ,UAAU,OAAO,iBAAiB,GAAG;AAChD,gBAAQ,IAAA;AACR,gBAAQ,IAAI,MAAM,KAAK,aAAa,CAAC;AACrC,gBAAQ,IAAI,MAAM,MAAM,eAAe,SAAS,aAAa,CAAC;AAC9D,gBAAQ,IAAI,MAAM,MAAM,+BAA+B,SAAS,CAAC;AACjE,gBAAQ,IAAI,MAAM,MAAM,oBAAoB,CAAC;AAAA,MAC/C;AAEA,cAAQ,IAAA;AAAA,IAEV,SAAS,OAAO;AACd,cAAQ,KAAK,mBAAmB;AAChC,cAAQ,MAAM,MAAM,IAAI,OAAO,KAAK,CAAC,CAAC;AACtC,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,CAAC;AAEH,SAAO;AACT;AAKO,SAAS,2BAAoC;AAClD,QAAM,UAAU,IAAI,QAAQ,aAAa;AAEzC,UACG,YAAY,sCAAsC;AAGrD,UACG,QAAQ,cAAc,EACtB,YAAY,qCAAqC,EACjD,OAAO,qBAAqB,qBAAqB,GAAG,EACpD,OAAO,qBAAqB,gFAAgF,EAC5G,OAAO,yBAAyB,gDAAgD,QAAQ,EACxF,OAAO,iBAAiB,sBAAsB,EAC9C,OAAO,eAAe,gCAAgC,EACtD,OAAO,aAAa,yBAAyB,EAC7C,OAAO,OAAO,QAAQ,YAAY;AACjC,UAAM,UAAU,IAAI,uBAAuB,EAAE,MAAA;AAE7C,QAAI;AACF,YAAM,cAAc,oBAAoB,QAAQ,IAAI;AACpD,YAAM,aAAa,UAAU;AAE7B,YAAM,OAAO,QAAQ,OAAO,QAAQ,KAAK,MAAM,GAAG,EAAE,IAAI,CAAC,MAAc,EAAE,KAAA,CAAM,IAAI,CAAA;AAEnF,YAAM,SAAS,MAAM,eAAe;AAAA,QAClC,QAAQ;AAAA,QACR;AAAA,QACA,MAAM,QAAQ;AAAA,QACd,QAAQ,QAAQ;AAAA,QAChB;AAAA,QACA,OAAO,QAAQ;AAAA,QACf,QAAQ,QAAQ;AAAA,MAAA,CACjB;AAED,UAAI,OAAO,SAAS;AAClB,gBAAQ,QAAQ,QAAQ,SAAS,sBAAsB,oBAAoB;AAAA,MAC7E,OAAO;AACL,gBAAQ,KAAK,uBAAuB;AAAA,MACtC;AAEA,cAAQ,IAAA;AACR,cAAQ,IAAI,MAAM,MAAM,YAAY,CAAC;AACrC,cAAQ,IAAI,MAAM,MAAM,iBAAiB,OAAO,YAAY,EAAE,CAAC;AAC/D,cAAQ,IAAI,MAAM,OAAO,iBAAiB,OAAO,YAAY,EAAE,CAAC;AAChE,cAAQ,IAAI,MAAM,KAAK,iBAAiB,OAAO,cAAc,EAAE,CAAC;AAEhE,UAAI,OAAO,OAAO,SAAS,GAAG;AAC5B,gBAAQ,IAAA;AACR,gBAAQ,IAAI,MAAM,IAAI,WAAW,CAAC;AAClC,eAAO,OAAO,QAAQ,CAAA,QAAO;AAC3B,kBAAQ,IAAI,MAAM,KAAK,SAAS,GAAG,EAAE,CAAC;AAAA,QACxC,CAAC;AAAA,MACH;AAEA,cAAQ,IAAA;AAAA,IAEV,SAAS,OAAO;AACd,cAAQ,KAAK,2BAA2B;AACxC,cAAQ,MAAM,MAAM,IAAI,OAAO,KAAK,CAAC,CAAC;AACtC,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,CAAC;AAGH,UACG,QAAQ,mBAAmB,EAC3B,YAAY,wCAAwC,EACpD,OAAO,qBAAqB,qBAAqB,GAAG,EACpD,OAAO,OAAO,QAAQ,YAAY;AACjC,UAAM,UAAU,IAAI,2BAA2B,EAAE,MAAA;AAEjD,QAAI;AACF,YAAM,cAAc,oBAAoB,QAAQ,IAAI;AACpD,YAAM,aAAa,UAAU;AAE7B,YAAM,SAAS,MAAM,oBAAoB,YAAY,WAAW;AAEhE,cAAQ,QAAQ,sBAAsB;AAEtC,cAAQ,IAAA;AACR,cAAQ,IAAI,MAAM,MAAM,2BAA2B,CAAC;AACpD,cAAQ,IAAI,MAAM,MAAM,iBAAiB,OAAO,KAAK,EAAE,CAAC;AACxD,cAAQ,IAAI,MAAM,IAAI,iBAAiB,OAAO,OAAO,EAAE,CAAC;AACxD,cAAQ,IAAI,MAAM,OAAO,iBAAiB,OAAO,OAAO,EAAE,CAAC;AAE3D,UAAI,OAAO,OAAO,SAAS,GAAG;AAC5B,gBAAQ,IAAA;AACR,gBAAQ,IAAI,MAAM,OAAO,iBAAiB,CAAC;AAC3C,eAAO,OAAO,MAAM,GAAG,EAAE,EAAE,QAAQ,CAAC,EAAE,MAAM,aAAa;AACvD,kBAAQ,IAAI,MAAM,MAAM,OAAO,IAAI,EAAE,CAAC;AACtC,iBAAO,QAAQ,CAAA,UAAS;AACtB,oBAAQ,IAAI,MAAM,KAAK,WAAW,KAAK,EAAE,CAAC;AAAA,UAC5C,CAAC;AAAA,QACH,CAAC;AACD,YAAI,OAAO,OAAO,SAAS,IAAI;AAC7B,kBAAQ,IAAI,MAAM,KAAK,eAAe,OAAO,OAAO,SAAS,EAAE,aAAa,CAAC;AAAA,QAC/E;AAEA,gBAAQ,IAAA;AACR,gBAAQ,IAAI,MAAM,KAAK,YAAY,IAAI,MAAM,MAAM,6BAA6B,CAAC;AAAA,MACnF;AAEA,cAAQ,IAAA;AAAA,IAEV,SAAS,OAAO;AACd,cAAQ,KAAK,mBAAmB;AAChC,cAAQ,MAAM,MAAM,IAAI,OAAO,KAAK,CAAC,CAAC;AACtC,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,CAAC;AAGH,UACG,QAAQ,iBAAiB,EACzB,YAAY,qDAAqD,EACjE,OAAO,qBAAqB,qBAAqB,GAAG,EACpD,OAAO,qBAAqB,0BAA0B,EACtD,OAAO,aAAa,yBAAyB,EAC7C,OAAO,OAAO,QAAQ,YAAY;AACjC,UAAM,UAAU,IAAI,yBAAyB,EAAE,MAAA;AAE/C,QAAI;AACF,YAAM,cAAc,oBAAoB,QAAQ,IAAI;AACpD,YAAM,aAAa,UAAU;AAE7B,YAAM,SAAS,MAAM,eAAe;AAAA,QAClC,QAAQ;AAAA,QACR;AAAA,QACA,MAAM,QAAQ;AAAA,QACd,OAAO;AAAA,QACP,QAAQ,QAAQ;AAAA,MAAA,CACjB;AAED,UAAI,OAAO,SAAS;AAClB,gBAAQ,QAAQ,QAAQ,SAAS,sBAAsB,sBAAsB;AAAA,MAC/E,OAAO;AACL,gBAAQ,KAAK,uBAAuB;AAAA,MACtC;AAEA,cAAQ,IAAA;AACR,cAAQ,IAAI,MAAM,MAAM,cAAc,OAAO,YAAY,QAAQ,CAAC;AAElE,UAAI,OAAO,OAAO,SAAS,GAAG;AAC5B,gBAAQ,IAAI,MAAM,IAAI,aAAa,OAAO,OAAO,MAAM,EAAE,CAAC;AAAA,MAC5D;AAEA,cAAQ,IAAA;AAAA,IAEV,SAAS,OAAO;AACd,cAAQ,KAAK,8BAA8B;AAC3C,cAAQ,MAAM,MAAM,IAAI,OAAO,KAAK,CAAC,CAAC;AACtC,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,CAAC;AAEH,SAAO;AACT;"}
+{"version":3,"file":"convert.js","sources":["../../../src/cli/commands/convert.ts"],"sourcesContent":["/**\n * Convert Command\n *\n * Convert existing documentation to weave-nn structure.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport { existsSync } from 'fs';\nimport { join } from 'path';\nimport {\n  convertDocs,\n  addFrontmatter,\n  validateFrontmatter,\n} from '../../generators/docs-convert.js';\nimport { validateProjectRoot, validateDocsPath } from '../../core/security.js';\n\n/**\n * Create convert command\n */\nexport function createConvertCommand(): Command {\n  const command = new Command('convert');\n\n  command\n    .description('Convert existing docs to weave-nn structure');\n\n  // Main convert subcommand\n  command\n    .command('docs')\n    .description('Convert existing documentation with proper structure')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-s, --source <dir>', 'Source docs directory', 'docs')\n    .option('-t, --target <dir>', 'Target directory', 'docs')\n    .option('--no-auto-category', 'Disable auto-categorization')\n    .option('-f, --force', 'Overwrite existing files')\n    .option('--dry-run', 'Show what would be done without making changes')\n    .action(async (options) => {\n      const spinner = ora('Converting documentation...').start();\n\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n        const sourceDir = options.source;\n        const targetDir = options.target;\n\n        // Check source exists\n        if (!existsSync(join(projectRoot, sourceDir))) {\n          spinner.fail(`Source directory not found: ${sourceDir}`);\n          console.log(chalk.gray('  Specify source with --source <dir>'));\n          process.exit(1);\n        }\n\n        if (options.dryRun) {\n          spinner.text = 'Analyzing documentation (dry run)...';\n        }\n\n        const result = await convertDocs({\n          sourceDir,\n          targetDir,\n          projectRoot,\n          preserveOriginal: true,\n          force: options.force,\n          autoCategory: options.autoCategory !== false,\n          dryRun: options.dryRun,\n        });\n\n        if (result.success) {\n          if (options.dryRun) {\n            spinner.succeed('Dry run complete!');\n          } else {\n            spinner.succeed('Documentation converted!');\n          }\n        } else {\n          spinner.warn('Conversion completed with errors');\n        }\n\n        console.log();\n        console.log(chalk.white('  Summary:'));\n        console.log(chalk.gray(`    Source:      ${sourceDir}/`));\n        console.log(chalk.gray(`    Target:      ${targetDir}/`));\n        console.log(chalk.green(`    Converted:   ${result.filesConverted}`));\n        console.log(chalk.yellow(`    Skipped:     ${result.filesSkipped}`));\n        console.log(chalk.gray(`    Total:       ${result.filesProcessed}`));\n\n        if (result.converted.length > 0 && result.converted.length <= 10) {\n          console.log();\n          console.log(chalk.white('  Converted files:'));\n          result.converted.forEach(({ source, target, type }) => {\n            console.log(chalk.gray(`    ${source}`));\n            console.log(chalk.cyan(`      → ${target}`) + chalk.gray(` [${type}]`));\n          });\n        } else if (result.converted.length > 10) {\n          console.log();\n          console.log(chalk.white('  Sample conversions:'));\n          result.converted.slice(0, 5).forEach(({ source, target, type }) => {\n            console.log(chalk.gray(`    ${source}`));\n            console.log(chalk.cyan(`      → ${target}`) + chalk.gray(` [${type}]`));\n          });\n          console.log(chalk.gray(`    ... and ${result.converted.length - 5} more`));\n        }\n\n        if (result.errors.length > 0) {\n          console.log();\n          console.log(chalk.red('  Errors:'));\n          result.errors.slice(0, 5).forEach(err => {\n            console.log(chalk.gray(`    - ${err}`));\n          });\n          if (result.errors.length > 5) {\n            console.log(chalk.gray(`    ... and ${result.errors.length - 5} more`));\n          }\n        }\n\n        if (!options.dryRun && result.filesConverted > 0) {\n          console.log();\n          console.log(chalk.cyan('Next steps:'));\n          console.log(chalk.white(`  1. Review ${targetDir}/ structure`));\n          console.log(chalk.white('  2. Run: kg graph --docs ' + targetDir));\n          console.log(chalk.white('  3. Run: kg stats'));\n        }\n\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Conversion failed');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  return command;\n}\n\n/**\n * Create frontmatter command\n */\nexport function createFrontmatterCommand(): Command {\n  const command = new Command('frontmatter');\n\n  command\n    .description('Manage frontmatter in markdown files');\n\n  // Add frontmatter\n  command\n    .command('add [target]')\n    .description('Add frontmatter to files missing it')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-t, --type <type>', 'Node type (concept, technical, feature, service, guide, standard, integration)')\n    .option('-s, --status <status>', 'Status (draft, active, deprecated, archived)', 'active')\n    .option('--tags <tags>', 'Comma-separated tags')\n    .option('-f, --force', 'Overwrite existing frontmatter')\n    .option('--dry-run', 'Show what would be done')\n    .action(async (target, options) => {\n      const spinner = ora('Adding frontmatter...').start();\n\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n        const targetPath = target || 'docs';\n\n        const tags = options.tags ? options.tags.split(',').map((t: string) => t.trim()) : [];\n\n        const result = await addFrontmatter({\n          target: targetPath,\n          projectRoot,\n          type: options.type,\n          status: options.status,\n          tags,\n          force: options.force,\n          dryRun: options.dryRun,\n        });\n\n        if (result.success) {\n          spinner.succeed(options.dryRun ? 'Dry run complete!' : 'Frontmatter added!');\n        } else {\n          spinner.warn('Completed with errors');\n        }\n\n        console.log();\n        console.log(chalk.white('  Summary:'));\n        console.log(chalk.green(`    Updated:  ${result.filesUpdated}`));\n        console.log(chalk.yellow(`    Skipped:  ${result.filesSkipped}`));\n        console.log(chalk.gray(`    Total:    ${result.filesProcessed}`));\n\n        if (result.errors.length > 0) {\n          console.log();\n          console.log(chalk.red('  Errors:'));\n          result.errors.forEach(err => {\n            console.log(chalk.gray(`    - ${err}`));\n          });\n        }\n\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Failed to add frontmatter');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  // Validate frontmatter\n  command\n    .command('validate [target]')\n    .description('Validate frontmatter in markdown files')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .action(async (target, options) => {\n      const spinner = ora('Validating frontmatter...').start();\n\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n        const targetPath = target || 'docs';\n\n        const result = await validateFrontmatter(targetPath, projectRoot);\n\n        spinner.succeed('Validation complete!');\n\n        console.log();\n        console.log(chalk.white('  Frontmatter Validation:'));\n        console.log(chalk.green(`    Valid:    ${result.valid}`));\n        console.log(chalk.red(`    Invalid:  ${result.invalid}`));\n        console.log(chalk.yellow(`    Missing:  ${result.missing}`));\n\n        if (result.issues.length > 0) {\n          console.log();\n          console.log(chalk.yellow('  Issues found:'));\n          result.issues.slice(0, 10).forEach(({ file, issues }) => {\n            console.log(chalk.white(`    ${file}`));\n            issues.forEach(issue => {\n              console.log(chalk.gray(`      - ${issue}`));\n            });\n          });\n          if (result.issues.length > 10) {\n            console.log(chalk.gray(`    ... and ${result.issues.length - 10} more files`));\n          }\n\n          console.log();\n          console.log(chalk.cyan('Fix with: ') + chalk.white('kg frontmatter add <target>'));\n        }\n\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Validation failed');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  // Update frontmatter (force mode)\n  command\n    .command('update [target]')\n    .description('Update/regenerate frontmatter (overwrites existing)')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-t, --type <type>', 'Force specific node type')\n    .option('--dry-run', 'Show what would be done')\n    .action(async (target, options) => {\n      const spinner = ora('Updating frontmatter...').start();\n\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n        const targetPath = target || 'docs';\n\n        const result = await addFrontmatter({\n          target: targetPath,\n          projectRoot,\n          type: options.type,\n          force: true,\n          dryRun: options.dryRun,\n        });\n\n        if (result.success) {\n          spinner.succeed(options.dryRun ? 'Dry run complete!' : 'Frontmatter updated!');\n        } else {\n          spinner.warn('Completed with errors');\n        }\n\n        console.log();\n        console.log(chalk.green(`  Updated: ${result.filesUpdated} files`));\n\n        if (result.errors.length > 0) {\n          console.log(chalk.red(`  Errors: ${result.errors.length}`));\n        }\n\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Failed to update frontmatter');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  return command;\n}\n"],"names":[],"mappings":"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"}