@weavelogic/knowledge-graph-agent 0.3.0 → 0.6.0

package/dist/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/cli/index.ts"],"sourcesContent":["/**\n * Knowledge Graph Agent CLI\n *\n * Main CLI setup and command registration.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport { createInitCommand } from './commands/init.js';\nimport { createGraphCommand } from './commands/graph.js';\nimport { createDocsCommand } from './commands/docs.js';\nimport { createClaudeCommand } from './commands/claude.js';\nimport { createSyncCommand } from './commands/sync.js';\nimport { createStatsCommand } from './commands/stats.js';\nimport { createSearchCommand } from './commands/search.js';\nimport { createConvertCommand, createFrontmatterCommand } from './commands/convert.js';\nimport { createAnalyzeCommand } from './commands/analyze.js';\nimport { createSOPCommands } from './commands/sop.js';\nimport { createInitPrimitivesCommand, createAnalyzeCodebaseCommand } from './commands/init-primitives.js';\nimport { createCultivateCommand } from './commands/cultivate.js';\nimport { createCommitCommand } from './commands/commit.js';\nimport { createConfigCommand } from './commands/config.js';\nimport { createDiagnosticsCommand } from './commands/diagnostics.js';\n\n/**\n * CLI version\n */\nconst VERSION = '0.3.0';\n\n/**\n * Create and configure the CLI program\n */\nexport function createCLI(): Command {\n  const program = new Command();\n\n  program\n    .name('kg')\n    .description('Knowledge Graph Agent - Generate and manage knowledge graphs for Claude Code')\n    .version(VERSION, '-v, --version', 'Display version number');\n\n  // Configure help\n  program.configureHelp({\n    sortSubcommands: true,\n    sortOptions: true,\n  });\n\n  // Add commands\n  program.addCommand(createInitCommand());\n  program.addCommand(createGraphCommand());\n  program.addCommand(createDocsCommand());\n  program.addCommand(createClaudeCommand());\n  program.addCommand(createSyncCommand());\n  program.addCommand(createStatsCommand());\n  program.addCommand(createSearchCommand());\n  program.addCommand(createConvertCommand());\n  program.addCommand(createFrontmatterCommand());\n  program.addCommand(createAnalyzeCommand());\n  program.addCommand(createSOPCommands());\n  program.addCommand(createInitPrimitivesCommand());\n  program.addCommand(createAnalyzeCodebaseCommand());\n  program.addCommand(createCultivateCommand());\n  program.addCommand(createCommitCommand());\n  program.addCommand(createConfigCommand());\n  program.addCommand(createDiagnosticsCommand());\n\n  // Default action (show help)\n  program.action(() => {\n    console.log(chalk.cyan.bold('\\n  Knowledge Graph Agent\\n'));\n    console.log(chalk.gray('  Generate and manage knowledge graphs for Claude Code\\n'));\n\n    console.log(chalk.white('  Quick Start:'));\n    console.log(chalk.gray('    $ kg init                  # Initialize knowledge graph'));\n    console.log(chalk.gray('    $ kg docs init             # Initialize docs directory'));\n    console.log(chalk.gray('    $ kg graph                 # Generate knowledge graph'));\n    console.log(chalk.gray('    $ kg claude update         # Update CLAUDE.md'));\n    console.log(chalk.gray('    $ kg sync                  # Sync with claude-flow\\n'));\n\n    console.log(chalk.white('  Migration & Analysis:'));\n    console.log(chalk.gray('    $ kg analyze               # Analyze & migrate to knowledge graph'));\n    console.log(chalk.gray('    $ kg analyze deep          # Deep analysis with claude-flow'));\n    console.log(chalk.gray('    $ kg analyze report        # Generate analysis report'));\n    console.log(chalk.gray('    $ kg convert docs          # Convert docs/ → docs-nn/'));\n    console.log(chalk.gray('    $ kg frontmatter add       # Add frontmatter to files'));\n    console.log(chalk.gray('    $ kg frontmatter validate  # Validate frontmatter\\n'));\n\n    console.log(chalk.white('  AI-SDLC SOP Compliance:'));\n    console.log(chalk.gray('    $ kg sop init              # Initialize SOP standards layer'));\n    console.log(chalk.gray('    $ kg sop check             # Check compliance against SOPs'));\n    console.log(chalk.gray('    $ kg sop gaps              # Analyze compliance gaps'));\n    console.log(chalk.gray('    $ kg sop report            # Generate compliance report'));\n    console.log(chalk.gray('    $ kg sop list              # List available SOPs\\n'));\n\n    console.log(chalk.white('  Cultivation & Primitives:'));\n    console.log(chalk.gray('    $ kg init-primitives       # Bootstrap primitives from codebase'));\n    console.log(chalk.gray('    $ kg analyze-codebase      # Analyze dependencies & services'));\n    console.log(chalk.gray('    $ kg init-primitives --dry-run  # Preview without writing\\n'));\n\n    console.log(chalk.white('  Git Integration:'));\n    console.log(chalk.gray('    $ kg commit                # Show status and suggested message'));\n    console.log(chalk.gray('    $ kg commit -a             # Auto-commit with generated message'));\n    console.log(chalk.gray('    $ kg commit -i             # Interactive commit mode'));\n    console.log(chalk.gray('    $ kg commit -m \"message\"   # Commit with custom message'));\n    console.log(chalk.gray('    $ kg commit status         # Show git status with analysis'));\n    console.log(chalk.gray('    $ kg commit log            # Show recent commits'));\n    console.log(chalk.gray('    $ kg commit diff           # Show diff of changes\\n'));\n\n    console.log(chalk.white('  Diagnostics & Health:'));\n    console.log(chalk.gray('    $ kg diag run              # Run full diagnostics'));\n    console.log(chalk.gray('    $ kg diag run --fix        # Attempt to fix issues'));\n    console.log(chalk.gray('    $ kg diag health           # Check system health'));\n    console.log(chalk.gray('    $ kg diag repair           # Repair database issues'));\n    console.log(chalk.gray('    $ kg diag backup           # Create database backup'));\n    console.log(chalk.gray('    $ kg diag backup --list    # List existing backups'));\n    console.log(chalk.gray('    $ kg diag info             # Show system information\\n'));\n\n    console.log(chalk.white('  Commands:'));\n    program.commands.forEach(cmd => {\n      console.log(chalk.cyan(`    ${cmd.name().padEnd(20)}`), chalk.gray(cmd.description() || ''));\n    });\n\n    console.log('\\n  Run', chalk.cyan('kg <command> --help'), 'for more information\\n');\n  });\n\n  return program;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../src/cli/index.ts"],"sourcesContent":["/**\n * Knowledge Graph Agent CLI\n *\n * Main CLI setup and command registration.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport { createInitCommand } from './commands/init.js';\nimport { createGraphCommand } from './commands/graph.js';\nimport { createDocsCommand } from './commands/docs.js';\nimport { createClaudeCommand } from './commands/claude.js';\nimport { createSyncCommand } from './commands/sync.js';\nimport { createStatsCommand } from './commands/stats.js';\nimport { createSearchCommand } from './commands/search.js';\nimport { createConvertCommand, createFrontmatterCommand } from './commands/convert.js';\nimport { createAnalyzeCommand } from './commands/analyze.js';\nimport { createSOPCommands } from './commands/sop.js';\nimport { createInitPrimitivesCommand, createAnalyzeCodebaseCommand } from './commands/init-primitives.js';\nimport { createCultivateCommand } from './commands/cultivate.js';\nimport { createCommitCommand } from './commands/commit.js';\nimport { createConfigCommand } from './commands/config.js';\nimport { createDiagnosticsCommand } from './commands/diagnostics.js';\nimport { createWorkflowCommand } from './commands/workflow.js';\nimport { createAuditCommand } from './commands/audit.js';\nimport { createVectorCommand } from './commands/vector.js';\nimport { createServeCommand } from './commands/serve.js';\nimport { createDashboardCommand } from './commands/dashboard.js';\nimport { createPluginCommand } from './commands/plugin.js';\n\n/**\n * CLI version\n */\nconst VERSION = '0.4.0';\n\n/**\n * Create and configure the CLI program\n */\nexport function createCLI(): Command {\n  const program = new Command();\n\n  program\n    .name('kg')\n    .description('Knowledge Graph Agent - Generate and manage knowledge graphs for Claude Code')\n    .version(VERSION, '-v, --version', 'Display version number');\n\n  // Configure help\n  program.configureHelp({\n    sortSubcommands: true,\n    sortOptions: true,\n  });\n\n  // Add commands\n  program.addCommand(createInitCommand());\n  program.addCommand(createGraphCommand());\n  program.addCommand(createDocsCommand());\n  program.addCommand(createClaudeCommand());\n  program.addCommand(createSyncCommand());\n  program.addCommand(createStatsCommand());\n  program.addCommand(createSearchCommand());\n  program.addCommand(createConvertCommand());\n  program.addCommand(createFrontmatterCommand());\n  program.addCommand(createAnalyzeCommand());\n  program.addCommand(createSOPCommands());\n  program.addCommand(createInitPrimitivesCommand());\n  program.addCommand(createAnalyzeCodebaseCommand());\n  program.addCommand(createCultivateCommand());\n  program.addCommand(createCommitCommand());\n  program.addCommand(createConfigCommand());\n  program.addCommand(createDiagnosticsCommand());\n  program.addCommand(createWorkflowCommand());\n  program.addCommand(createAuditCommand());\n  program.addCommand(createVectorCommand());\n  program.addCommand(createServeCommand());\n  program.addCommand(createDashboardCommand());\n  program.addCommand(createPluginCommand());\n\n  // Default action (show help)\n  program.action(() => {\n    console.log(chalk.cyan.bold('\\n  Knowledge Graph Agent\\n'));\n    console.log(chalk.gray('  Generate and manage knowledge graphs for Claude Code\\n'));\n\n    console.log(chalk.white('  Quick Start:'));\n    console.log(chalk.gray('    $ kg init                  # Initialize knowledge graph'));\n    console.log(chalk.gray('    $ kg docs init             # Initialize docs directory'));\n    console.log(chalk.gray('    $ kg graph                 # Generate knowledge graph'));\n    console.log(chalk.gray('    $ kg claude update         # Update CLAUDE.md'));\n    console.log(chalk.gray('    $ kg sync                  # Sync with claude-flow\\n'));\n\n    console.log(chalk.white('  Migration & Analysis:'));\n    console.log(chalk.gray('    $ kg analyze               # Analyze & migrate to knowledge graph'));\n    console.log(chalk.gray('    $ kg analyze deep          # Deep analysis with claude-flow'));\n    console.log(chalk.gray('    $ kg analyze report        # Generate analysis report'));\n    console.log(chalk.gray('    $ kg convert docs          # Convert docs/ → docs-nn/'));\n    console.log(chalk.gray('    $ kg frontmatter add       # Add frontmatter to files'));\n    console.log(chalk.gray('    $ kg frontmatter validate  # Validate frontmatter\\n'));\n\n    console.log(chalk.white('  AI-SDLC SOP Compliance:'));\n    console.log(chalk.gray('    $ kg sop init              # Initialize SOP standards layer'));\n    console.log(chalk.gray('    $ kg sop check             # Check compliance against SOPs'));\n    console.log(chalk.gray('    $ kg sop gaps              # Analyze compliance gaps'));\n    console.log(chalk.gray('    $ kg sop report            # Generate compliance report'));\n    console.log(chalk.gray('    $ kg sop list              # List available SOPs\\n'));\n\n    console.log(chalk.white('  Cultivation & Primitives:'));\n    console.log(chalk.gray('    $ kg init-primitives       # Bootstrap primitives from codebase'));\n    console.log(chalk.gray('    $ kg analyze-codebase      # Analyze dependencies & services'));\n    console.log(chalk.gray('    $ kg init-primitives --dry-run  # Preview without writing\\n'));\n\n    console.log(chalk.white('  Git Integration:'));\n    console.log(chalk.gray('    $ kg commit                # Show status and suggested message'));\n    console.log(chalk.gray('    $ kg commit -a             # Auto-commit with generated message'));\n    console.log(chalk.gray('    $ kg commit -i             # Interactive commit mode'));\n    console.log(chalk.gray('    $ kg commit -m \"message\"   # Commit with custom message'));\n    console.log(chalk.gray('    $ kg commit status         # Show git status with analysis'));\n    console.log(chalk.gray('    $ kg commit log            # Show recent commits'));\n    console.log(chalk.gray('    $ kg commit diff           # Show diff of changes\\n'));\n\n    console.log(chalk.white('  Diagnostics & Health:'));\n    console.log(chalk.gray('    $ kg diag run              # Run full diagnostics'));\n    console.log(chalk.gray('    $ kg diag run --fix        # Attempt to fix issues'));\n    console.log(chalk.gray('    $ kg diag health           # Check system health'));\n    console.log(chalk.gray('    $ kg diag repair           # Repair database issues'));\n    console.log(chalk.gray('    $ kg diag backup           # Create database backup'));\n    console.log(chalk.gray('    $ kg diag backup --list    # List existing backups'));\n    console.log(chalk.gray('    $ kg diag info             # Show system information\\n'));\n\n    console.log(chalk.white('  Workflow Management:'));\n    console.log(chalk.gray('    $ kg workflow start <type> # Start a workflow'));\n    console.log(chalk.gray('    $ kg workflow status [id]  # Check workflow status'));\n    console.log(chalk.gray('    $ kg workflow list         # List active workflows'));\n    console.log(chalk.gray('    $ kg workflow stop <id>    # Stop a workflow'));\n    console.log(chalk.gray('    $ kg workflow history      # Show workflow history\\n'));\n\n    console.log(chalk.white('  Vector Operations:'));\n    console.log(chalk.gray('    $ kg vector search <query> # Semantic search'));\n    console.log(chalk.gray('    $ kg vector stats          # Vector store statistics'));\n    console.log(chalk.gray('    $ kg vector rebuild        # Rebuild vector index'));\n    console.log(chalk.gray('    $ kg vector traj list      # List trajectories'));\n    console.log(chalk.gray('    $ kg vector traj show <id> # Show trajectory details'));\n    console.log(chalk.gray('    $ kg vector traj patterns  # Show detected patterns\\n'));\n\n    console.log(chalk.white('  Audit & Exochain:'));\n    console.log(chalk.gray('    $ kg audit query           # Query the audit log'));\n    console.log(chalk.gray('    $ kg audit checkpoint      # Create a checkpoint'));\n    console.log(chalk.gray('    $ kg audit verify          # Verify chain integrity'));\n    console.log(chalk.gray('    $ kg audit sync status     # Check sync status'));\n    console.log(chalk.gray('    $ kg audit sync peers      # List sync peers'));\n    console.log(chalk.gray('    $ kg audit export          # Export audit log\\n'));\n\n    console.log(chalk.white('  Server Mode:'));\n    console.log(chalk.gray('    $ kg serve                 # Start MCP server (stdio)'));\n    console.log(chalk.gray('    $ kg serve --graphql       # Start GraphQL server'));\n    console.log(chalk.gray('    $ kg serve --dashboard     # Start web dashboard'));\n    console.log(chalk.gray('    $ kg serve --all           # Start all servers'));\n    console.log(chalk.gray('    $ kg serve status          # Show server status\\n'));\n\n    console.log(chalk.white('  Dashboard:'));\n    console.log(chalk.gray('    $ kg dashboard start       # Start dashboard dev server'));\n    console.log(chalk.gray('    $ kg dashboard build       # Build dashboard for production'));\n    console.log(chalk.gray('    $ kg dashboard serve       # Serve built dashboard'));\n    console.log(chalk.gray('    $ kg dashboard open        # Open dashboard in browser'));\n    console.log(chalk.gray('    $ kg dashboard status      # Check dashboard status\\n'));\n\n    console.log(chalk.white('  Plugin Management:'));\n    console.log(chalk.gray('    $ kg plugin list           # List installed plugins'));\n    console.log(chalk.gray('    $ kg plugin install <pkg>  # Install a plugin'));\n    console.log(chalk.gray('    $ kg plugin uninstall <n>  # Uninstall a plugin'));\n    console.log(chalk.gray('    $ kg plugin enable <name>  # Enable a plugin'));\n    console.log(chalk.gray('    $ kg plugin disable <name> # Disable a plugin'));\n    console.log(chalk.gray('    $ kg plugin info <name>    # Show plugin details'));\n    console.log(chalk.gray('    $ kg plugin run <n> <file> # Run analyzer plugin'));\n    console.log(chalk.gray('    $ kg plugin create <name>  # Create new plugin\\n'));\n\n    console.log(chalk.white('  Commands:'));\n    program.commands.forEach(cmd => {\n      console.log(chalk.cyan(`    ${cmd.name().padEnd(20)}`), chalk.gray(cmd.description() || ''));\n    });\n\n    console.log('\\n  Run', chalk.cyan('kg <command> --help'), 'for more information\\n');\n  });\n\n  return program;\n}\n"],"names":[],"mappings":"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"}

package/dist/config/manager.js

@@ -0,0 +1,325 @@
+import { existsSync, readFileSync, mkdirSync, writeFileSync } from "fs";
+import { join, dirname } from "path";
+import { createLogger } from "../utils/logger.js";
+const logger = createLogger("config-manager");
+const DEFAULT_CONFIG = {
+  version: "1.0.0",
+  projectRoot: process.cwd(),
+  docsPath: "docs",
+  database: {
+    path: ".kg/knowledge.db",
+    autoBackup: true,
+    backupInterval: 864e5,
+    // 24 hours
+    maxBackups: 5
+  },
+  cache: {
+    enabled: true,
+    maxSize: 1e3,
+    ttl: 36e5,
+    // 1 hour
+    evictionPolicy: "lru"
+  },
+  agents: {
+    maxConcurrent: 5,
+    defaultTimeout: 3e4,
+    // 30 seconds
+    retryAttempts: 3,
+    claudeFlowEnabled: true
+  },
+  services: {
+    watcherEnabled: true,
+    schedulerEnabled: true,
+    syncEnabled: true,
+    healthCheckInterval: 6e4
+    // 1 minute
+  },
+  logging: {
+    level: "info",
+    format: "text"
+  }
+};
+class ConfigManager {
+  config;
+  configPath;
+  migrations = [];
+  /**
+   * Create a new ConfigManager instance
+   *
+   * @param projectRoot - Root directory of the project
+   * @param configPath - Optional custom config file path
+   */
+  constructor(projectRoot, configPath) {
+    this.configPath = configPath || join(projectRoot, ".kg/config.json");
+    this.config = this.load();
+    this.config.projectRoot = projectRoot;
+  }
+  /**
+   * Load configuration from file
+   *
+   * @returns Loaded configuration merged with defaults
+   */
+  load() {
+    if (!existsSync(this.configPath)) {
+      logger.debug("No config file found, using defaults", { path: this.configPath });
+      return { ...DEFAULT_CONFIG };
+    }
+    try {
+      const data = readFileSync(this.configPath, "utf-8");
+      const loaded = JSON.parse(data);
+      logger.debug("Loaded configuration", { path: this.configPath, version: loaded.version });
+      return this.mergeWithDefaults(loaded);
+    } catch (error) {
+      logger.warn("Failed to load config, using defaults", {
+        error: error instanceof Error ? error.message : String(error)
+      });
+      return { ...DEFAULT_CONFIG };
+    }
+  }
+  /**
+   * Merge loaded configuration with defaults
+   *
+   * @param loaded - Partially loaded configuration
+   * @returns Complete configuration with defaults filled in
+   */
+  mergeWithDefaults(loaded) {
+    return {
+      ...DEFAULT_CONFIG,
+      ...loaded,
+      database: { ...DEFAULT_CONFIG.database, ...loaded.database },
+      cache: { ...DEFAULT_CONFIG.cache, ...loaded.cache },
+      agents: { ...DEFAULT_CONFIG.agents, ...loaded.agents },
+      services: { ...DEFAULT_CONFIG.services, ...loaded.services },
+      logging: { ...DEFAULT_CONFIG.logging, ...loaded.logging }
+    };
+  }
+  /**
+   * Save configuration to file
+   */
+  save() {
+    const dir = dirname(this.configPath);
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true });
+    }
+    try {
+      writeFileSync(this.configPath, JSON.stringify(this.config, null, 2));
+      logger.info("Configuration saved", { path: this.configPath });
+    } catch (error) {
+      logger.error("Failed to save configuration", error instanceof Error ? error : void 0, {
+        path: this.configPath
+      });
+      throw error;
+    }
+  }
+  /**
+   * Get a configuration value by key
+   *
+   * @param key - Configuration key
+   * @returns Configuration value for the key
+   */
+  get(key) {
+    return this.config[key];
+  }
+  /**
+   * Set a configuration value
+   *
+   * @param key - Configuration key
+   * @param value - Value to set
+   */
+  set(key, value) {
+    this.config[key] = value;
+    this.save();
+  }
+  /**
+   * Update multiple configuration values
+   *
+   * @param updates - Partial configuration to merge
+   */
+  update(updates) {
+    this.config = this.mergeWithDefaults({ ...this.config, ...updates });
+    this.save();
+  }
+  /**
+   * Get the complete configuration
+   *
+   * @returns Complete configuration object (copy)
+   */
+  getAll() {
+    return { ...this.config };
+  }
+  /**
+   * Register a configuration migration
+   *
+   * @param migration - Migration definition
+   */
+  registerMigration(migration) {
+    this.migrations.push(migration);
+    this.migrations.sort((a, b) => a.version.localeCompare(b.version, void 0, { numeric: true }));
+    logger.debug("Registered migration", { version: migration.version });
+  }
+  /**
+   * Run migrations to target version
+   *
+   * @param targetVersion - Target version to migrate to (defaults to latest)
+   */
+  migrate(targetVersion) {
+    const currentVersion = this.config.version;
+    const target = targetVersion || this.migrations[this.migrations.length - 1]?.version || currentVersion;
+    if (currentVersion === target) {
+      logger.info("Config already at target version", { version: target });
+      return;
+    }
+    const isUpgrade = this.compareVersions(currentVersion, target) < 0;
+    const applicableMigrations = this.migrations.filter((m) => {
+      if (isUpgrade) {
+        return this.compareVersions(m.version, currentVersion) > 0 && this.compareVersions(m.version, target) <= 0;
+      } else {
+        return this.compareVersions(m.version, currentVersion) <= 0 && this.compareVersions(m.version, target) > 0;
+      }
+    });
+    if (!isUpgrade) {
+      applicableMigrations.reverse();
+    }
+    for (const migration of applicableMigrations) {
+      logger.info(`Applying migration ${migration.version}`, {
+        direction: isUpgrade ? "up" : "down"
+      });
+      try {
+        const result = isUpgrade ? migration.up(this.config) : migration.down(this.config);
+        this.config = this.mergeWithDefaults(result);
+        this.config.version = isUpgrade ? migration.version : this.getPreviousVersion(migration.version);
+      } catch (error) {
+        logger.error(
+          `Migration ${migration.version} failed`,
+          error instanceof Error ? error : void 0
+        );
+        throw error;
+      }
+    }
+    this.config.version = target;
+    this.save();
+    logger.info("Migration complete", { from: currentVersion, to: target });
+  }
+  /**
+   * Compare two version strings
+   *
+   * @param a - First version
+   * @param b - Second version
+   * @returns Negative if a < b, 0 if equal, positive if a > b
+   */
+  compareVersions(a, b) {
+    const partsA = a.split(".").map(Number);
+    const partsB = b.split(".").map(Number);
+    for (let i = 0; i < Math.max(partsA.length, partsB.length); i++) {
+      const partA = partsA[i] || 0;
+      const partB = partsB[i] || 0;
+      if (partA !== partB) {
+        return partA - partB;
+      }
+    }
+    return 0;
+  }
+  /**
+   * Get the version before a given version
+   *
+   * @param version - Current version
+   * @returns Previous version string
+   */
+  getPreviousVersion(version) {
+    const index = this.migrations.findIndex((m) => m.version === version);
+    if (index > 0) {
+      return this.migrations[index - 1].version;
+    }
+    const parts = version.split(".").map(Number);
+    if (parts[2] > 0) {
+      parts[2]--;
+    } else if (parts[1] > 0) {
+      parts[1]--;
+      parts[2] = 0;
+    } else if (parts[0] > 0) {
+      parts[0]--;
+      parts[1] = 0;
+      parts[2] = 0;
+    }
+    return parts.join(".");
+  }
+  /**
+   * Reset configuration to defaults
+   */
+  reset() {
+    this.config = { ...DEFAULT_CONFIG, projectRoot: this.config.projectRoot };
+    this.save();
+    logger.info("Configuration reset to defaults");
+  }
+  /**
+   * Get the configuration file path
+   *
+   * @returns Path to the configuration file
+   */
+  getConfigPath() {
+    return this.configPath;
+  }
+  /**
+   * Check if configuration file exists
+   *
+   * @returns True if config file exists
+   */
+  exists() {
+    return existsSync(this.configPath);
+  }
+  /**
+   * Validate the current configuration
+   *
+   * @returns Validation result with any errors
+   */
+  validate() {
+    const errors = [];
+    if (!this.config.version.match(/^\d+\.\d+\.\d+$/)) {
+      errors.push("Invalid version format, expected semver (e.g., 1.0.0)");
+    }
+    if (!this.config.database.path) {
+      errors.push("Database path is required");
+    }
+    if (this.config.database.backupInterval < 0) {
+      errors.push("Database backup interval must be non-negative");
+    }
+    if (this.config.database.maxBackups < 0) {
+      errors.push("Database max backups must be non-negative");
+    }
+    if (this.config.cache.maxSize < 0) {
+      errors.push("Cache max size must be non-negative");
+    }
+    if (this.config.cache.ttl < 0) {
+      errors.push("Cache TTL must be non-negative");
+    }
+    if (!["lru", "lfu", "fifo"].includes(this.config.cache.evictionPolicy)) {
+      errors.push("Invalid cache eviction policy");
+    }
+    if (this.config.agents.maxConcurrent < 1) {
+      errors.push("Agents max concurrent must be at least 1");
+    }
+    if (this.config.agents.defaultTimeout < 0) {
+      errors.push("Agents default timeout must be non-negative");
+    }
+    if (this.config.agents.retryAttempts < 0) {
+      errors.push("Agents retry attempts must be non-negative");
+    }
+    if (this.config.services.healthCheckInterval < 0) {
+      errors.push("Health check interval must be non-negative");
+    }
+    if (!["debug", "info", "warn", "error"].includes(this.config.logging.level)) {
+      errors.push("Invalid logging level");
+    }
+    if (!["json", "text"].includes(this.config.logging.format)) {
+      errors.push("Invalid logging format");
+    }
+    return {
+      valid: errors.length === 0,
+      errors
+    };
+  }
+}
+export {
+  ConfigManager
+};
+//# sourceMappingURL=manager.js.map

package/dist/config/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sources":["../../src/config/manager.ts"],"sourcesContent":["/**\n * Configuration Manager\n *\n * Manages Knowledge Graph configuration with migration support,\n * persistence, and validation.\n *\n * @module config/manager\n */\n\nimport { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';\nimport { join, dirname } from 'path';\nimport { createLogger } from '../utils/index.js';\nimport type {\n  KGConfiguration,\n  ConfigMigration,\n  DatabaseConfig,\n  CacheConfig,\n  AgentConfig,\n  ServicesConfig,\n  LoggingConfig,\n} from './types.js';\n\nconst logger = createLogger('config-manager');\n\n/**\n * Default configuration values\n */\nconst DEFAULT_CONFIG: KGConfiguration = {\n  version: '1.0.0',\n  projectRoot: process.cwd(),\n  docsPath: 'docs',\n  database: {\n    path: '.kg/knowledge.db',\n    autoBackup: true,\n    backupInterval: 86400000, // 24 hours\n    maxBackups: 5,\n  },\n  cache: {\n    enabled: true,\n    maxSize: 1000,\n    ttl: 3600000, // 1 hour\n    evictionPolicy: 'lru',\n  },\n  agents: {\n    maxConcurrent: 5,\n    defaultTimeout: 30000, // 30 seconds\n    retryAttempts: 3,\n    claudeFlowEnabled: true,\n  },\n  services: {\n    watcherEnabled: true,\n    schedulerEnabled: true,\n    syncEnabled: true,\n    healthCheckInterval: 60000, // 1 minute\n  },\n  logging: {\n    level: 'info',\n    format: 'text',\n  },\n};\n\n/**\n * Configuration Manager class\n *\n * Handles loading, saving, and migrating configuration files.\n */\nexport class ConfigManager {\n  private config: KGConfiguration;\n  private configPath: string;\n  private migrations: ConfigMigration[] = [];\n\n  /**\n   * Create a new ConfigManager instance\n   *\n   * @param projectRoot - Root directory of the project\n   * @param configPath - Optional custom config file path\n   */\n  constructor(projectRoot: string, configPath?: string) {\n    this.configPath = configPath || join(projectRoot, '.kg/config.json');\n    this.config = this.load();\n    // Update projectRoot to match the actual project root\n    this.config.projectRoot = projectRoot;\n  }\n\n  /**\n   * Load configuration from file\n   *\n   * @returns Loaded configuration merged with defaults\n   */\n  private load(): KGConfiguration {\n    if (!existsSync(this.configPath)) {\n      logger.debug('No config file found, using defaults', { path: this.configPath });\n      return { ...DEFAULT_CONFIG };\n    }\n\n    try {\n      const data = readFileSync(this.configPath, 'utf-8');\n      const loaded = JSON.parse(data) as Partial<KGConfiguration>;\n      logger.debug('Loaded configuration', { path: this.configPath, version: loaded.version });\n      return this.mergeWithDefaults(loaded);\n    } catch (error) {\n      logger.warn('Failed to load config, using defaults', {\n        error: error instanceof Error ? error.message : String(error),\n      });\n      return { ...DEFAULT_CONFIG };\n    }\n  }\n\n  /**\n   * Merge loaded configuration with defaults\n   *\n   * @param loaded - Partially loaded configuration\n   * @returns Complete configuration with defaults filled in\n   */\n  private mergeWithDefaults(loaded: Partial<KGConfiguration>): KGConfiguration {\n    return {\n      ...DEFAULT_CONFIG,\n      ...loaded,\n      database: { ...DEFAULT_CONFIG.database, ...loaded.database } as DatabaseConfig,\n      cache: { ...DEFAULT_CONFIG.cache, ...loaded.cache } as CacheConfig,\n      agents: { ...DEFAULT_CONFIG.agents, ...loaded.agents } as AgentConfig,\n      services: { ...DEFAULT_CONFIG.services, ...loaded.services } as ServicesConfig,\n      logging: { ...DEFAULT_CONFIG.logging, ...loaded.logging } as LoggingConfig,\n    };\n  }\n\n  /**\n   * Save configuration to file\n   */\n  save(): void {\n    const dir = dirname(this.configPath);\n    if (!existsSync(dir)) {\n      mkdirSync(dir, { recursive: true });\n    }\n\n    try {\n      writeFileSync(this.configPath, JSON.stringify(this.config, null, 2));\n      logger.info('Configuration saved', { path: this.configPath });\n    } catch (error) {\n      logger.error('Failed to save configuration', error instanceof Error ? error : undefined, {\n        path: this.configPath,\n      });\n      throw error;\n    }\n  }\n\n  /**\n   * Get a configuration value by key\n   *\n   * @param key - Configuration key\n   * @returns Configuration value for the key\n   */\n  get<K extends keyof KGConfiguration>(key: K): KGConfiguration[K] {\n    return this.config[key];\n  }\n\n  /**\n   * Set a configuration value\n   *\n   * @param key - Configuration key\n   * @param value - Value to set\n   */\n  set<K extends keyof KGConfiguration>(key: K, value: KGConfiguration[K]): void {\n    this.config[key] = value;\n    this.save();\n  }\n\n  /**\n   * Update multiple configuration values\n   *\n   * @param updates - Partial configuration to merge\n   */\n  update(updates: Partial<KGConfiguration>): void {\n    this.config = this.mergeWithDefaults({ ...this.config, ...updates });\n    this.save();\n  }\n\n  /**\n   * Get the complete configuration\n   *\n   * @returns Complete configuration object (copy)\n   */\n  getAll(): KGConfiguration {\n    return { ...this.config };\n  }\n\n  /**\n   * Register a configuration migration\n   *\n   * @param migration - Migration definition\n   */\n  registerMigration(migration: ConfigMigration): void {\n    this.migrations.push(migration);\n    // Sort migrations by version\n    this.migrations.sort((a, b) => a.version.localeCompare(b.version, undefined, { numeric: true }));\n    logger.debug('Registered migration', { version: migration.version });\n  }\n\n  /**\n   * Run migrations to target version\n   *\n   * @param targetVersion - Target version to migrate to (defaults to latest)\n   */\n  migrate(targetVersion?: string): void {\n    const currentVersion = this.config.version;\n    const target =\n      targetVersion || this.migrations[this.migrations.length - 1]?.version || currentVersion;\n\n    if (currentVersion === target) {\n      logger.info('Config already at target version', { version: target });\n      return;\n    }\n\n    const isUpgrade = this.compareVersions(currentVersion, target) < 0;\n\n    // Filter applicable migrations\n    const applicableMigrations = this.migrations.filter((m) => {\n      if (isUpgrade) {\n        return (\n          this.compareVersions(m.version, currentVersion) > 0 &&\n          this.compareVersions(m.version, target) <= 0\n        );\n      } else {\n        return (\n          this.compareVersions(m.version, currentVersion) <= 0 &&\n          this.compareVersions(m.version, target) > 0\n        );\n      }\n    });\n\n    // Reverse order for downgrades\n    if (!isUpgrade) {\n      applicableMigrations.reverse();\n    }\n\n    // Apply migrations\n    for (const migration of applicableMigrations) {\n      logger.info(`Applying migration ${migration.version}`, {\n        direction: isUpgrade ? 'up' : 'down',\n      });\n\n      try {\n        const result = isUpgrade ? migration.up(this.config) : migration.down(this.config);\n        this.config = this.mergeWithDefaults(result);\n        this.config.version = isUpgrade\n          ? migration.version\n          : this.getPreviousVersion(migration.version);\n      } catch (error) {\n        logger.error(\n          `Migration ${migration.version} failed`,\n          error instanceof Error ? error : undefined\n        );\n        throw error;\n      }\n    }\n\n    // Set final version\n    this.config.version = target;\n    this.save();\n    logger.info('Migration complete', { from: currentVersion, to: target });\n  }\n\n  /**\n   * Compare two version strings\n   *\n   * @param a - First version\n   * @param b - Second version\n   * @returns Negative if a < b, 0 if equal, positive if a > b\n   */\n  private compareVersions(a: string, b: string): number {\n    const partsA = a.split('.').map(Number);\n    const partsB = b.split('.').map(Number);\n\n    for (let i = 0; i < Math.max(partsA.length, partsB.length); i++) {\n      const partA = partsA[i] || 0;\n      const partB = partsB[i] || 0;\n      if (partA !== partB) {\n        return partA - partB;\n      }\n    }\n    return 0;\n  }\n\n  /**\n   * Get the version before a given version\n   *\n   * @param version - Current version\n   * @returns Previous version string\n   */\n  private getPreviousVersion(version: string): string {\n    const index = this.migrations.findIndex((m) => m.version === version);\n    if (index > 0) {\n      return this.migrations[index - 1].version;\n    }\n    // Return a default previous version\n    const parts = version.split('.').map(Number);\n    if (parts[2] > 0) {\n      parts[2]--;\n    } else if (parts[1] > 0) {\n      parts[1]--;\n      parts[2] = 0;\n    } else if (parts[0] > 0) {\n      parts[0]--;\n      parts[1] = 0;\n      parts[2] = 0;\n    }\n    return parts.join('.');\n  }\n\n  /**\n   * Reset configuration to defaults\n   */\n  reset(): void {\n    this.config = { ...DEFAULT_CONFIG, projectRoot: this.config.projectRoot };\n    this.save();\n    logger.info('Configuration reset to defaults');\n  }\n\n  /**\n   * Get the configuration file path\n   *\n   * @returns Path to the configuration file\n   */\n  getConfigPath(): string {\n    return this.configPath;\n  }\n\n  /**\n   * Check if configuration file exists\n   *\n   * @returns True if config file exists\n   */\n  exists(): boolean {\n    return existsSync(this.configPath);\n  }\n\n  /**\n   * Validate the current configuration\n   *\n   * @returns Validation result with any errors\n   */\n  validate(): { valid: boolean; errors: string[] } {\n    const errors: string[] = [];\n\n    // Validate version\n    if (!this.config.version.match(/^\\d+\\.\\d+\\.\\d+$/)) {\n      errors.push('Invalid version format, expected semver (e.g., 1.0.0)');\n    }\n\n    // Validate database config\n    if (!this.config.database.path) {\n      errors.push('Database path is required');\n    }\n    if (this.config.database.backupInterval < 0) {\n      errors.push('Database backup interval must be non-negative');\n    }\n    if (this.config.database.maxBackups < 0) {\n      errors.push('Database max backups must be non-negative');\n    }\n\n    // Validate cache config\n    if (this.config.cache.maxSize < 0) {\n      errors.push('Cache max size must be non-negative');\n    }\n    if (this.config.cache.ttl < 0) {\n      errors.push('Cache TTL must be non-negative');\n    }\n    if (!['lru', 'lfu', 'fifo'].includes(this.config.cache.evictionPolicy)) {\n      errors.push('Invalid cache eviction policy');\n    }\n\n    // Validate agents config\n    if (this.config.agents.maxConcurrent < 1) {\n      errors.push('Agents max concurrent must be at least 1');\n    }\n    if (this.config.agents.defaultTimeout < 0) {\n      errors.push('Agents default timeout must be non-negative');\n    }\n    if (this.config.agents.retryAttempts < 0) {\n      errors.push('Agents retry attempts must be non-negative');\n    }\n\n    // Validate services config\n    if (this.config.services.healthCheckInterval < 0) {\n      errors.push('Health check interval must be non-negative');\n    }\n\n    // Validate logging config\n    if (!['debug', 'info', 'warn', 'error'].includes(this.config.logging.level)) {\n      errors.push('Invalid logging level');\n    }\n    if (!['json', 'text'].includes(this.config.logging.format)) {\n      errors.push('Invalid logging format');\n    }\n\n    return {\n      valid: errors.length === 0,\n      errors,\n    };\n  }\n}\n\n/**\n * Create a new ConfigManager instance\n *\n * @param projectRoot - Root directory of the project\n * @param configPath - Optional custom config file path\n * @returns ConfigManager instance\n */\nexport function createConfigManager(projectRoot: string, configPath?: string): ConfigManager {\n  return new ConfigManager(projectRoot, configPath);\n}\n\n/**\n * Get a copy of the default configuration\n *\n * @returns Default configuration object\n */\nexport function getDefaultConfig(): KGConfiguration {\n  return { ...DEFAULT_CONFIG };\n}\n"],"names":[],"mappings":"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"}

package/dist/dashboard-server/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Dashboard Module
+ *
+ * Provides dashboard server functionality for the Knowledge Graph Agent.
+ * Supports development and production modes with GraphQL endpoint detection.
+ *
+ * @module dashboard
+ *
+ * @example
+ * ```typescript
+ * import { createDashboardServer, createDashboardConfig } from './dashboard';
+ *
+ * const config = createDashboardConfig(process.cwd(), {
+ *   port: 3000,
+ *   mode: 'development',
+ * });
+ *
+ * const server = createDashboardServer(config);
+ * await server.start();
+ *
+ * // Check GraphQL connection
+ * const connected = await server.checkGraphQLConnection();
+ *
+ * // Later...
+ * await server.stop();
+ * ```
+ */
+export type { DashboardMode, DashboardConfig, DashboardStatus, DashboardState, DashboardEventType, IDashboardServer, } from './server.js';
+export { DashboardServer, } from './server.js';
+export { createDashboardServer, createDashboardConfig, } from './server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/dashboard-server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dashboard-server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,YAAY,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,GAChB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,aAAa,CAAC"}

package/dist/dashboard-server/server.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Dashboard Server
+ *
+ * Server integration for the Knowledge Graph Dashboard.
+ * Supports running Next.js in development and production modes,
+ * with programmatic control and concurrent server support.
+ *
+ * @module dashboard/server
+ */
+/**
+ * Dashboard server mode
+ */
+export type DashboardMode = 'development' | 'production';
+/**
+ * Dashboard server configuration
+ */
+export interface DashboardConfig {
+    /** Project root directory */
+    projectRoot: string;
+    /** Port to listen on */
+    port: number;
+    /** GraphQL server endpoint URL */
+    graphqlEndpoint: string;
+    /** Server mode (development or production) */
+    mode: DashboardMode;
+    /** Output directory for production build */
+    outputDir?: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Path to dashboard source (defaults to dashboard/ in project) */
+    dashboardPath?: string;
+}
+/**
+ * Dashboard server status
+ */
+export type DashboardStatus = 'stopped' | 'starting' | 'running' | 'stopping' | 'error';
+/**
+ * Dashboard server state
+ */
+export interface DashboardState {
+    /** Current status */
+    status: DashboardStatus;
+    /** Port the server is listening on */
+    port?: number;
+    /** GraphQL endpoint being used */
+    graphqlEndpoint?: string;
+    /** When the server started */
+    startedAt?: Date;
+    /** Error message if status is 'error' */
+    error?: string;
+    /** Server mode */
+    mode?: DashboardMode;
+    /** Whether GraphQL connection is established */
+    graphqlConnected?: boolean;
+}
+/**
+ * Dashboard server event types
+ */
+export type DashboardEventType = 'starting' | 'started' | 'stopping' | 'stopped' | 'error' | 'build:started' | 'build:completed' | 'build:failed' | 'graphql:connected' | 'graphql:disconnected';
+/**
+ * Dashboard server interface
+ */
+export interface IDashboardServer {
+    /** Start the dashboard server */
+    start(): Promise<void>;
+    /** Stop the dashboard server */
+    stop(): Promise<void>;
+    /** Build the dashboard for production */
+    build(): Promise<void>;
+    /** Get current server state */
+    getState(): DashboardState;
+    /** Check GraphQL connection */
+    checkGraphQLConnection(): Promise<boolean>;
+    /** Wait for the server to shutdown (blocks until stopped) */
+    waitForShutdown(): Promise<void>;
+    /** Subscribe to events */
+    on(event: DashboardEventType, listener: (...args: unknown[]) => void): void;
+    /** Unsubscribe from events */
+    off(event: DashboardEventType, listener: (...args: unknown[]) => void): void;
+}
+/**
+ * DashboardServer
+ *
+ * Manages the Knowledge Graph Dashboard web interface.
+ * Supports both development (with hot reload) and production modes.
+ *
+ * @example
+ * ```typescript
+ * const server = new DashboardServer({
+ *   projectRoot: process.cwd(),
+ *   port: 3000,
+ *   graphqlEndpoint: 'http://localhost:4000/graphql',
+ *   mode: 'development',
+ * });
+ *
+ * await server.start();
+ *
+ * // Later...
+ * await server.stop();
+ * ```
+ */
+export declare class DashboardServer implements IDashboardServer {
+    private config;
+    private state;
+    private eventEmitter;
+    private childProcess;
+    private httpServer;
+    private graphqlCheckInterval;
+    private shutdownPromise;
+    private shutdownResolve;
+    constructor(config: DashboardConfig);
+    /**
+     * Detect the dashboard path
+     */
+    private detectDashboardPath;
+    /**
+     * Check if dashboard is installed
+     */
+    private isDashboardInstalled;
+    /**
+     * Start the dashboard server
+     */
+    start(): Promise<void>;
+    /**
+     * Start the development server (Next.js dev)
+     */
+    private startDevelopmentServer;
+    /**
+     * Start the production server (Next.js start or static file server)
+     */
+    private startProductionServer;
+    /**
+     * Start a fallback static server when dashboard is not installed
+     */
+    private startFallbackServer;
+    /**
+     * Handle requests to the fallback server
+     */
+    private handleFallbackRequest;
+    /**
+     * Get fallback HTML when dashboard is not fully installed
+     */
+    private getFallbackHTML;
+    /**
+     * Stop the dashboard server
+     */
+    stop(): Promise<void>;
+    /**
+     * Kill the child process
+     */
+    private killChildProcess;
+    /**
+     * Close the HTTP server
+     */
+    private closeHttpServer;
+    /**
+     * Build the dashboard for production
+     */
+    build(): Promise<void>;
+    /**
+     * Start GraphQL connection monitoring
+     */
+    private startGraphQLMonitoring;
+    /**
+     * Stop GraphQL connection monitoring
+     */
+    private stopGraphQLMonitoring;
+    /**
+     * Check if GraphQL connection is available
+     */
+    checkGraphQLConnection(): Promise<boolean>;
+    /**
+     * Get current server state
+     */
+    getState(): DashboardState;
+    /**
+     * Wait for the server to shutdown
+     */
+    waitForShutdown(): Promise<void>;
+    /**
+     * Emit an event
+     */
+    private emit;
+    /**
+     * Subscribe to events
+     */
+    on(event: DashboardEventType, listener: (...args: unknown[]) => void): void;
+    /**
+     * Unsubscribe from events
+     */
+    off(event: DashboardEventType, listener: (...args: unknown[]) => void): void;
+    /**
+     * Subscribe to an event once
+     */
+    once(event: DashboardEventType, listener: (...args: unknown[]) => void): void;
+}
+/**
+ * Create a new dashboard server instance
+ */
+export declare function createDashboardServer(config: DashboardConfig): DashboardServer;
+/**
+ * Create dashboard configuration with defaults
+ */
+export declare function createDashboardConfig(projectRoot: string, overrides?: Partial<DashboardConfig>): DashboardConfig;
+//# sourceMappingURL=server.d.ts.map

package/dist/dashboard-server/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/dashboard-server/server.ts"],"names":[],"mappings":"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"}