@weavelogic/knowledge-graph-agent 0.2.0 → 0.3.0

package/dist/cli/commands/cultivate.js

@@ -0,0 +1,254 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import { resolve } from "path";
+import { SeedGenerator } from "../../cultivation/seed-generator.js";
+import { loadShadowCache } from "../../core/cache.js";
+function createCultivateCommand() {
+  return new Command("cultivate").description("Systematically cultivate and enhance the knowledge graph").argument("[path]", "Directory to cultivate (defaults to current directory)", ".").option("--dry-run", "Preview changes without executing", false).option("-d, --docs <path>", "Documentation path", "docs").option("-v, --verbose", "Verbose output", false).option("--seed", "Bootstrap vault with primitives from codebase analysis", false).option("--deep-analysis", "Use claude-flow agents for deep analysis", false).option("--cache", "Use shadow cache for incremental updates", true).option("--ecosystem <ecosystems>", "Filter to specific ecosystems (comma-separated)", void 0).option("--include-dev", "Include dev dependencies", false).option("--major-only", "Only process major dependencies", false).option("--refresh-cache", "Force refresh the shadow cache", false).action(async (targetPath, options) => {
+    const projectRoot = resolve(targetPath);
+    const docsPath = options.docs || "docs";
+    const verbose = options.verbose || false;
+    const dryRun = options.dryRun || false;
+    console.log(chalk.bold.green("\n🌱 Knowledge Graph Cultivator\n"));
+    console.log(`  Project: ${projectRoot}`);
+    console.log(`  Docs: ${docsPath}`);
+    if (dryRun) {
+      console.log(`  Mode: ${chalk.yellow("Dry Run")}`);
+    }
+    console.log("");
+    const tasks = {
+      seed: options.seed || false,
+      deepAnalysis: options.deepAnalysis || false
+    };
+    if (!tasks.seed && !tasks.deepAnalysis) {
+      console.log(chalk.yellow("💡 No tasks selected. Use one or more of:"));
+      console.log("  --seed           Bootstrap vault with primitives from codebase");
+      console.log("  --deep-analysis  Use claude-flow for deep codebase analysis");
+      console.log("");
+      console.log(chalk.gray("Options:"));
+      console.log("  --dry-run        Preview without writing files");
+      console.log("  --cache          Use shadow cache for incremental updates (default: true)");
+      console.log("  --refresh-cache  Force refresh the shadow cache");
+      console.log("  --ecosystem      Filter to ecosystems (nodejs,python,rust,go,php,java)");
+      console.log("  --include-dev    Include dev dependencies");
+      console.log("  --major-only     Only process major dependencies");
+      console.log("");
+      console.log('Run "kg cultivate --help" for more options');
+      return;
+    }
+    const startTime = Date.now();
+    const result = {
+      success: true,
+      seed: { created: 0, documents: [] },
+      analysis: { filesProcessed: 0, dependenciesFound: 0, servicesFound: 0 },
+      cache: { updated: 0, hits: 0, misses: 0 },
+      duration: 0,
+      warnings: [],
+      errors: []
+    };
+    try {
+      let cache;
+      if (options.cache !== false) {
+        console.log(chalk.cyan("📦 Initializing shadow cache..."));
+        cache = await loadShadowCache(projectRoot);
+        if (options.refreshCache) {
+          cache.clear();
+          console.log(chalk.gray("  Cache cleared (refresh mode)"));
+        }
+        const stats = cache.getStats();
+        console.log(chalk.gray(`  Entries: ${stats.totalEntries}, Hit rate: ${(stats.hitRate * 100).toFixed(1)}%`));
+        console.log("");
+      }
+      if (tasks.seed) {
+        console.log(chalk.cyan("🌱 Seeding primitives from codebase...\n"));
+        let ecosystems;
+        if (options.ecosystem) {
+          ecosystems = options.ecosystem.split(",").map((e) => e.trim());
+          console.log(chalk.gray(`  Ecosystems: ${ecosystems.join(", ")}`));
+        }
+        const generator = await SeedGenerator.create(projectRoot, docsPath);
+        console.log(chalk.gray("  Analyzing codebase..."));
+        const analysis = await generator.analyze();
+        result.analysis = {
+          filesProcessed: analysis.metadata.filesScanned,
+          dependenciesFound: analysis.dependencies.length,
+          servicesFound: analysis.services.length
+        };
+        console.log(`
+  ${chalk.bold("Analysis Results:")}`);
+        console.log(`    Languages: ${analysis.languages.join(", ") || "none"}`);
+        console.log(`    Dependencies: ${analysis.dependencies.length}`);
+        console.log(`    Frameworks: ${analysis.frameworks.length}`);
+        console.log(`    Services: ${analysis.services.length}`);
+        console.log(`    Deployments: ${analysis.deployments.length}`);
+        if (verbose) {
+          displayDetailedAnalysis(analysis);
+        }
+        console.log("");
+        console.log(chalk.gray("  Generating primitive nodes..."));
+        const documents = await generator.generatePrimitives(analysis);
+        if (dryRun) {
+          console.log(`
+  ${chalk.yellow("[DRY RUN]")} Would create ${documents.length} primitives:`);
+          for (const doc of documents.slice(0, 10)) {
+            console.log(`    - ${doc.frontmatter.type}: ${doc.title}`);
+          }
+          if (documents.length > 10) {
+            console.log(`    ... and ${documents.length - 10} more`);
+          }
+          result.seed.documents = documents.map((d) => ({
+            title: d.title,
+            path: d.path,
+            type: d.frontmatter.type || "unknown"
+          }));
+        } else {
+          const writeResult = await generator.writePrimitives(documents);
+          result.seed.created = writeResult.documentsGenerated.length;
+          result.seed.documents = writeResult.documentsGenerated;
+          console.log(`
+  ${chalk.green("✓")} Created ${writeResult.documentsGenerated.length} primitives`);
+          if (writeResult.warnings.length > 0) {
+            result.warnings.push(...writeResult.warnings);
+            if (verbose) {
+              console.log(chalk.yellow(`  Warnings: ${writeResult.warnings.length}`));
+            }
+          }
+          if (writeResult.errors.length > 0) {
+            result.errors.push(...writeResult.errors);
+            console.log(chalk.red(`  Errors: ${writeResult.errors.length}`));
+          }
+        }
+        console.log("");
+      }
+      if (tasks.deepAnalysis) {
+        console.log(chalk.cyan("🧠 Running deep analysis with claude-flow...\n"));
+        const hasClaudeFlow = await checkClaudeFlowAvailable();
+        if (!hasClaudeFlow) {
+          console.log(chalk.yellow("  ⚠️  claude-flow not available"));
+          console.log(chalk.gray("  Install with: npm install -g claude-flow@alpha"));
+          result.warnings.push("claude-flow not available for deep analysis");
+        } else {
+          if (dryRun) {
+            console.log(chalk.yellow("  [DRY RUN] Would spawn claude-flow agents:"));
+            console.log("    - Researcher: Analyze codebase patterns");
+            console.log("    - Analyst: Identify architectural decisions");
+            console.log("    - Coder: Detect implementation patterns");
+            console.log("    - Tester: Analyze testing coverage");
+          } else {
+            try {
+              const { DeepAnalyzer } = await import("../../cultivation/deep-analyzer.js");
+              const analyzer = new DeepAnalyzer({
+                projectRoot,
+                docsPath,
+                verbose
+              });
+              const deepResult = await analyzer.analyze();
+              console.log(`  ${chalk.green("✓")} Deep analysis complete`);
+              console.log(`    Agents spawned: ${deepResult.agentsSpawned}`);
+              console.log(`    Insights generated: ${deepResult.insightsCount}`);
+              console.log(`    Documentation created: ${deepResult.documentsCreated}`);
+            } catch (error) {
+              result.errors.push(`Deep analysis failed: ${error instanceof Error ? error.message : String(error)}`);
+              console.log(chalk.red(`  ✗ Deep analysis failed: ${error instanceof Error ? error.message : String(error)}`));
+            }
+          }
+        }
+        console.log("");
+      }
+      if (cache) {
+        const stats = cache.getStats();
+        result.cache = {
+          updated: stats.totalEntries,
+          hits: stats.hitCount,
+          misses: stats.missCount
+        };
+        await cache.save();
+      }
+      result.duration = Date.now() - startTime;
+      result.success = result.errors.length === 0;
+      displaySummary(result, dryRun);
+    } catch (error) {
+      console.error(chalk.red("\n❌ Cultivation failed:"), error);
+      process.exit(1);
+    }
+  });
+}
+function displayDetailedAnalysis(analysis) {
+  if (analysis.frameworks.length > 0) {
+    console.log(`
+    ${chalk.gray("Frameworks:")}`);
+    for (const fw of analysis.frameworks) {
+      console.log(`      - ${fw.name} (${fw.ecosystem}) v${fw.version}`);
+    }
+  }
+  if (analysis.services.length > 0) {
+    console.log(`
+    ${chalk.gray("Services:")}`);
+    for (const svc of analysis.services) {
+      console.log(`      - ${svc.name}: ${svc.type} (${svc.technology})`);
+    }
+  }
+  if (analysis.deployments.length > 0) {
+    console.log(`
+    ${chalk.gray("Deployments:")}`);
+    for (const dep of analysis.deployments) {
+      console.log(`      - ${dep}`);
+    }
+  }
+}
+function displaySummary(result, dryRun) {
+  console.log(chalk.bold.blue("📊 Cultivation Summary\n"));
+  if (dryRun) {
+    console.log(chalk.yellow("[DRY RUN] No changes were made\n"));
+  }
+  console.log("  Analysis:");
+  console.log(`    Files processed: ${result.analysis.filesProcessed}`);
+  console.log(`    Dependencies: ${result.analysis.dependenciesFound}`);
+  console.log(`    Services: ${result.analysis.servicesFound}`);
+  if (result.seed.created > 0 || result.seed.documents.length > 0) {
+    console.log("\n  Seed:");
+    console.log(`    Primitives ${dryRun ? "would create" : "created"}: ${dryRun ? result.seed.documents.length : result.seed.created}`);
+  }
+  if (result.cache.updated > 0) {
+    console.log("\n  Cache:");
+    console.log(`    Entries: ${result.cache.updated}`);
+    const hitRate = result.cache.hits + result.cache.misses > 0 ? (result.cache.hits / (result.cache.hits + result.cache.misses) * 100).toFixed(1) : 0;
+    console.log(`    Hit rate: ${hitRate}%`);
+  }
+  console.log(`
+  Duration: ${(result.duration / 1e3).toFixed(2)}s`);
+  if (result.warnings.length > 0) {
+    console.log(chalk.yellow(`
+  ⚠️  Warnings: ${result.warnings.length}`));
+    for (const warning of result.warnings.slice(0, 5)) {
+      console.log(chalk.gray(`    - ${warning}`));
+    }
+  }
+  if (result.errors.length > 0) {
+    console.log(chalk.red(`
+  ❌ Errors: ${result.errors.length}`));
+    for (const error of result.errors.slice(0, 5)) {
+      console.log(chalk.gray(`    - ${error}`));
+    }
+  }
+  if (result.success && !dryRun) {
+    console.log(chalk.bold.green("\n✨ Cultivation complete!\n"));
+  } else if (!result.success) {
+    console.log(chalk.yellow("\n⚠️  Cultivation completed with errors\n"));
+  } else {
+    console.log(chalk.gray("\nRun without --dry-run to apply changes\n"));
+  }
+}
+async function checkClaudeFlowAvailable() {
+  try {
+    const { execSync } = await import("child_process");
+    execSync("npx claude-flow@alpha --version", { stdio: "pipe", timeout: 5e3 });
+    return true;
+  } catch {
+    return false;
+  }
+}
+export {
+  createCultivateCommand
+};
+//# sourceMappingURL=cultivate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cultivate.js","sources":["../../../src/cli/commands/cultivate.ts"],"sourcesContent":["/**\n * Cultivate Command - Systematically enhance the knowledge graph\n *\n * This command provides cultivation tasks:\n * - Seed primitives from codebase analysis\n * - Deep analysis with claude-flow integration\n * - Graph enhancement and optimization\n *\n * @module cli/commands/cultivate\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport { resolve, join, relative } from 'path';\nimport { existsSync, mkdirSync, readFileSync, readdirSync, statSync } from 'fs';\nimport { SeedGenerator } from '../../cultivation/seed-generator.js';\nimport { ShadowCache, loadShadowCache } from '../../core/cache.js';\nimport type { CultivationOptions, Ecosystem, SeedAnalysis } from '../../cultivation/types.js';\n\n/**\n * Cultivation result\n */\ninterface CultivationResult {\n  success: boolean;\n  seed: {\n    created: number;\n    documents: Array<{ title: string; path: string; type: string }>;\n  };\n  analysis: {\n    filesProcessed: number;\n    dependenciesFound: number;\n    servicesFound: number;\n  };\n  cache: {\n    updated: number;\n    hits: number;\n    misses: number;\n  };\n  duration: number;\n  warnings: string[];\n  errors: string[];\n}\n\n/**\n * Create cultivate command\n */\nexport function createCultivateCommand(): Command {\n  return new Command('cultivate')\n    .description('Systematically cultivate and enhance the knowledge graph')\n    .argument('[path]', 'Directory to cultivate (defaults to current directory)', '.')\n    .option('--dry-run', 'Preview changes without executing', false)\n    .option('-d, --docs <path>', 'Documentation path', 'docs')\n    .option('-v, --verbose', 'Verbose output', false)\n    .option('--seed', 'Bootstrap vault with primitives from codebase analysis', false)\n    .option('--deep-analysis', 'Use claude-flow agents for deep analysis', false)\n    .option('--cache', 'Use shadow cache for incremental updates', true)\n    .option('--ecosystem <ecosystems>', 'Filter to specific ecosystems (comma-separated)', undefined)\n    .option('--include-dev', 'Include dev dependencies', false)\n    .option('--major-only', 'Only process major dependencies', false)\n    .option('--refresh-cache', 'Force refresh the shadow cache', false)\n    .action(async (targetPath: string, options: {\n      dryRun?: boolean;\n      docs?: string;\n      verbose?: boolean;\n      seed?: boolean;\n      deepAnalysis?: boolean;\n      cache?: boolean;\n      ecosystem?: string;\n      includeDev?: boolean;\n      majorOnly?: boolean;\n      refreshCache?: boolean;\n    }) => {\n      const projectRoot = resolve(targetPath);\n      const docsPath = options.docs || 'docs';\n      const verbose = options.verbose || false;\n      const dryRun = options.dryRun || false;\n\n      console.log(chalk.bold.green('\\n🌱 Knowledge Graph Cultivator\\n'));\n      console.log(`  Project: ${projectRoot}`);\n      console.log(`  Docs: ${docsPath}`);\n      if (dryRun) {\n        console.log(`  Mode: ${chalk.yellow('Dry Run')}`);\n      }\n      console.log('');\n\n      // Determine tasks\n      const tasks = {\n        seed: options.seed || false,\n        deepAnalysis: options.deepAnalysis || false,\n      };\n\n      // If no tasks selected, show help\n      if (!tasks.seed && !tasks.deepAnalysis) {\n        console.log(chalk.yellow('💡 No tasks selected. Use one or more of:'));\n        console.log('  --seed           Bootstrap vault with primitives from codebase');\n        console.log('  --deep-analysis  Use claude-flow for deep codebase analysis');\n        console.log('');\n        console.log(chalk.gray('Options:'));\n        console.log('  --dry-run        Preview without writing files');\n        console.log('  --cache          Use shadow cache for incremental updates (default: true)');\n        console.log('  --refresh-cache  Force refresh the shadow cache');\n        console.log('  --ecosystem      Filter to ecosystems (nodejs,python,rust,go,php,java)');\n        console.log('  --include-dev    Include dev dependencies');\n        console.log('  --major-only     Only process major dependencies');\n        console.log('');\n        console.log('Run \"kg cultivate --help\" for more options');\n        return;\n      }\n\n      const startTime = Date.now();\n      const result: CultivationResult = {\n        success: true,\n        seed: { created: 0, documents: [] },\n        analysis: { filesProcessed: 0, dependenciesFound: 0, servicesFound: 0 },\n        cache: { updated: 0, hits: 0, misses: 0 },\n        duration: 0,\n        warnings: [],\n        errors: [],\n      };\n\n      try {\n        // Initialize shadow cache\n        let cache: ShadowCache | undefined;\n        if (options.cache !== false) {\n          console.log(chalk.cyan('📦 Initializing shadow cache...'));\n          cache = await loadShadowCache(projectRoot);\n\n          if (options.refreshCache) {\n            cache.clear();\n            console.log(chalk.gray('  Cache cleared (refresh mode)'));\n          }\n\n          const stats = cache.getStats();\n          console.log(chalk.gray(`  Entries: ${stats.totalEntries}, Hit rate: ${(stats.hitRate * 100).toFixed(1)}%`));\n          console.log('');\n        }\n\n        // Task 1: Seed primitives\n        if (tasks.seed) {\n          console.log(chalk.cyan('🌱 Seeding primitives from codebase...\\n'));\n\n          // Parse ecosystem filter\n          let ecosystems: Ecosystem[] | undefined;\n          if (options.ecosystem) {\n            ecosystems = options.ecosystem.split(',').map(e => e.trim() as Ecosystem);\n            console.log(chalk.gray(`  Ecosystems: ${ecosystems.join(', ')}`));\n          }\n\n          // Create generator\n          const generator = await SeedGenerator.create(projectRoot, docsPath);\n\n          // Analyze\n          console.log(chalk.gray('  Analyzing codebase...'));\n          const analysis = await generator.analyze();\n\n          result.analysis = {\n            filesProcessed: analysis.metadata.filesScanned,\n            dependenciesFound: analysis.dependencies.length,\n            servicesFound: analysis.services.length,\n          };\n\n          // Display analysis\n          console.log(`\\n  ${chalk.bold('Analysis Results:')}`);\n          console.log(`    Languages: ${analysis.languages.join(', ') || 'none'}`);\n          console.log(`    Dependencies: ${analysis.dependencies.length}`);\n          console.log(`    Frameworks: ${analysis.frameworks.length}`);\n          console.log(`    Services: ${analysis.services.length}`);\n          console.log(`    Deployments: ${analysis.deployments.length}`);\n\n          if (verbose) {\n            displayDetailedAnalysis(analysis);\n          }\n\n          console.log('');\n\n          // Generate primitives\n          console.log(chalk.gray('  Generating primitive nodes...'));\n          const documents = await generator.generatePrimitives(analysis);\n\n          if (dryRun) {\n            console.log(`\\n  ${chalk.yellow('[DRY RUN]')} Would create ${documents.length} primitives:`);\n            for (const doc of documents.slice(0, 10)) {\n              console.log(`    - ${doc.frontmatter.type}: ${doc.title}`);\n            }\n            if (documents.length > 10) {\n              console.log(`    ... and ${documents.length - 10} more`);\n            }\n            result.seed.documents = documents.map(d => ({\n              title: d.title,\n              path: d.path,\n              type: d.frontmatter.type || 'unknown',\n            }));\n          } else {\n            const writeResult = await generator.writePrimitives(documents);\n            result.seed.created = writeResult.documentsGenerated.length;\n            result.seed.documents = writeResult.documentsGenerated;\n\n            console.log(`\\n  ${chalk.green('✓')} Created ${writeResult.documentsGenerated.length} primitives`);\n\n            if (writeResult.warnings.length > 0) {\n              result.warnings.push(...writeResult.warnings);\n              if (verbose) {\n                console.log(chalk.yellow(`  Warnings: ${writeResult.warnings.length}`));\n              }\n            }\n\n            if (writeResult.errors.length > 0) {\n              result.errors.push(...writeResult.errors);\n              console.log(chalk.red(`  Errors: ${writeResult.errors.length}`));\n            }\n          }\n\n          console.log('');\n        }\n\n        // Task 2: Deep Analysis with claude-flow\n        if (tasks.deepAnalysis) {\n          console.log(chalk.cyan('🧠 Running deep analysis with claude-flow...\\n'));\n\n          // Check if claude-flow is available\n          const hasClaudeFlow = await checkClaudeFlowAvailable();\n\n          if (!hasClaudeFlow) {\n            console.log(chalk.yellow('  ⚠️  claude-flow not available'));\n            console.log(chalk.gray('  Install with: npm install -g claude-flow@alpha'));\n            result.warnings.push('claude-flow not available for deep analysis');\n          } else {\n            if (dryRun) {\n              console.log(chalk.yellow('  [DRY RUN] Would spawn claude-flow agents:'));\n              console.log('    - Researcher: Analyze codebase patterns');\n              console.log('    - Analyst: Identify architectural decisions');\n              console.log('    - Coder: Detect implementation patterns');\n              console.log('    - Tester: Analyze testing coverage');\n            } else {\n              // Import and run DeepAnalyzer\n              try {\n                const { DeepAnalyzer } = await import('../../cultivation/deep-analyzer.js');\n                const analyzer = new DeepAnalyzer({\n                  projectRoot,\n                  docsPath,\n                  verbose,\n                });\n\n                const deepResult = await analyzer.analyze();\n\n                console.log(`  ${chalk.green('✓')} Deep analysis complete`);\n                console.log(`    Agents spawned: ${deepResult.agentsSpawned}`);\n                console.log(`    Insights generated: ${deepResult.insightsCount}`);\n                console.log(`    Documentation created: ${deepResult.documentsCreated}`);\n              } catch (error) {\n                result.errors.push(`Deep analysis failed: ${error instanceof Error ? error.message : String(error)}`);\n                console.log(chalk.red(`  ✗ Deep analysis failed: ${error instanceof Error ? error.message : String(error)}`));\n              }\n            }\n          }\n\n          console.log('');\n        }\n\n        // Update cache\n        if (cache) {\n          const stats = cache.getStats();\n          result.cache = {\n            updated: stats.totalEntries,\n            hits: stats.hitCount,\n            misses: stats.missCount,\n          };\n\n          await cache.save();\n        }\n\n        result.duration = Date.now() - startTime;\n        result.success = result.errors.length === 0;\n\n        // Final summary\n        displaySummary(result, dryRun);\n\n      } catch (error) {\n        console.error(chalk.red('\\n❌ Cultivation failed:'), error);\n        process.exit(1);\n      }\n    });\n}\n\n/**\n * Display detailed analysis output\n */\nfunction displayDetailedAnalysis(analysis: SeedAnalysis): void {\n  if (analysis.frameworks.length > 0) {\n    console.log(`\\n    ${chalk.gray('Frameworks:')}`);\n    for (const fw of analysis.frameworks) {\n      console.log(`      - ${fw.name} (${fw.ecosystem}) v${fw.version}`);\n    }\n  }\n\n  if (analysis.services.length > 0) {\n    console.log(`\\n    ${chalk.gray('Services:')}`);\n    for (const svc of analysis.services) {\n      console.log(`      - ${svc.name}: ${svc.type} (${svc.technology})`);\n    }\n  }\n\n  if (analysis.deployments.length > 0) {\n    console.log(`\\n    ${chalk.gray('Deployments:')}`);\n    for (const dep of analysis.deployments) {\n      console.log(`      - ${dep}`);\n    }\n  }\n}\n\n/**\n * Display cultivation summary\n */\nfunction displaySummary(result: CultivationResult, dryRun: boolean): void {\n  console.log(chalk.bold.blue('📊 Cultivation Summary\\n'));\n\n  if (dryRun) {\n    console.log(chalk.yellow('[DRY RUN] No changes were made\\n'));\n  }\n\n  console.log('  Analysis:');\n  console.log(`    Files processed: ${result.analysis.filesProcessed}`);\n  console.log(`    Dependencies: ${result.analysis.dependenciesFound}`);\n  console.log(`    Services: ${result.analysis.servicesFound}`);\n\n  if (result.seed.created > 0 || result.seed.documents.length > 0) {\n    console.log('\\n  Seed:');\n    console.log(`    Primitives ${dryRun ? 'would create' : 'created'}: ${dryRun ? result.seed.documents.length : result.seed.created}`);\n  }\n\n  if (result.cache.updated > 0) {\n    console.log('\\n  Cache:');\n    console.log(`    Entries: ${result.cache.updated}`);\n    const hitRate = result.cache.hits + result.cache.misses > 0\n      ? (result.cache.hits / (result.cache.hits + result.cache.misses) * 100).toFixed(1)\n      : 0;\n    console.log(`    Hit rate: ${hitRate}%`);\n  }\n\n  console.log(`\\n  Duration: ${(result.duration / 1000).toFixed(2)}s`);\n\n  if (result.warnings.length > 0) {\n    console.log(chalk.yellow(`\\n  ⚠️  Warnings: ${result.warnings.length}`));\n    for (const warning of result.warnings.slice(0, 5)) {\n      console.log(chalk.gray(`    - ${warning}`));\n    }\n  }\n\n  if (result.errors.length > 0) {\n    console.log(chalk.red(`\\n  ❌ Errors: ${result.errors.length}`));\n    for (const error of result.errors.slice(0, 5)) {\n      console.log(chalk.gray(`    - ${error}`));\n    }\n  }\n\n  if (result.success && !dryRun) {\n    console.log(chalk.bold.green('\\n✨ Cultivation complete!\\n'));\n  } else if (!result.success) {\n    console.log(chalk.yellow('\\n⚠️  Cultivation completed with errors\\n'));\n  } else {\n    console.log(chalk.gray('\\nRun without --dry-run to apply changes\\n'));\n  }\n}\n\n/**\n * Check if claude-flow is available\n */\nasync function checkClaudeFlowAvailable(): Promise<boolean> {\n  try {\n    const { execSync } = await import('child_process');\n    execSync('npx claude-flow@alpha --version', { stdio: 'pipe', timeout: 5000 });\n    return true;\n  } catch {\n    return false;\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/commands/diagnostics.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Diagnostics Command
+ *
+ * System diagnostics and health monitoring for knowledge graph.
+ */
+import { Command } from 'commander';
+export declare function createDiagnosticsCommand(): Command;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/cli/commands/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/diagnostics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,wBAAgB,wBAAwB,IAAI,OAAO,CA8IlD"}

package/dist/cli/commands/diagnostics.js

@@ -0,0 +1,140 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import { join } from "path";
+import { existsSync } from "fs";
+import { createHealthMonitor, createDatabaseCheck, createMemoryCheck, createDiskCheck } from "../../health/index.js";
+import { createIntegrityChecker } from "../../recovery/index.js";
+function createDiagnosticsCommand() {
+  const diagnostics = new Command("diagnostics").alias("diag").description("System diagnostics and health monitoring");
+  diagnostics.command("health").description("Run health checks on all components").option("--json", "Output as JSON").action(async (options) => {
+    try {
+      const cwd = process.cwd();
+      const dbPath = join(cwd, ".kg", "knowledge.db");
+      const monitor = createHealthMonitor();
+      monitor.register(createDatabaseCheck(dbPath));
+      monitor.register(createMemoryCheck(500));
+      monitor.register(createDiskCheck(cwd));
+      console.log(chalk.cyan("Running health checks...\n"));
+      const health = await monitor.check();
+      if (options.json) {
+        console.log(JSON.stringify(health, null, 2));
+      } else {
+        printHealth(health);
+      }
+      if (health.status === "unhealthy") {
+        process.exit(1);
+      }
+    } catch (error) {
+      console.error(chalk.red("Error running health checks:"), error);
+      process.exit(1);
+    }
+  });
+  diagnostics.command("integrity").description("Check database integrity").option("--repair", "Attempt to repair issues").action(async (options) => {
+    try {
+      const cwd = process.cwd();
+      const dbPath = join(cwd, ".kg", "knowledge.db");
+      if (!existsSync(dbPath)) {
+        console.log(chalk.yellow('Database not found. Run "kg init" first.'));
+        process.exit(1);
+      }
+      console.log(chalk.cyan("Checking database integrity...\n"));
+      const checker = createIntegrityChecker(dbPath);
+      const result = await checker.check();
+      if (result.valid) {
+        console.log(chalk.green("Database integrity: OK"));
+      } else {
+        console.log(chalk.red("Database integrity: FAILED"));
+        result.issues.forEach((issue) => {
+          console.log(chalk.yellow(`  - ${issue}`));
+        });
+        if (options.repair) {
+          console.log(chalk.cyan("\nAttempting repairs..."));
+          const repairResult = await checker.repair();
+          if (repairResult.repaired) {
+            console.log(chalk.green("Repairs completed"));
+            repairResult.actions.forEach((action) => {
+              console.log(chalk.gray(`  - ${action}`));
+            });
+          } else {
+            console.log(chalk.red("Some repairs failed"));
+            process.exit(1);
+          }
+        }
+      }
+      console.log(chalk.gray(`
+Check completed in ${result.duration}ms`));
+    } catch (error) {
+      console.error(chalk.red("Error checking integrity:"), error);
+      process.exit(1);
+    }
+  });
+  diagnostics.command("memory").description("Show memory usage statistics").action(() => {
+    const usage = process.memoryUsage();
+    console.log(chalk.cyan.bold("\nMemory Usage:\n"));
+    console.log(chalk.white(`  Heap Used:     ${formatBytes(usage.heapUsed)}`));
+    console.log(chalk.white(`  Heap Total:    ${formatBytes(usage.heapTotal)}`));
+    console.log(chalk.white(`  RSS:           ${formatBytes(usage.rss)}`));
+    console.log(chalk.white(`  External:      ${formatBytes(usage.external)}`));
+    console.log(chalk.white(`  Array Buffers: ${formatBytes(usage.arrayBuffers)}`));
+    console.log("");
+  });
+  diagnostics.command("status").description("Show overall system status").action(async () => {
+    try {
+      const cwd = process.cwd();
+      const kgDir = join(cwd, ".kg");
+      const dbPath = join(kgDir, "knowledge.db");
+      console.log(chalk.cyan.bold("\nKnowledge Graph Status:\n"));
+      const initialized = existsSync(kgDir);
+      console.log(chalk.white("Initialized:"), initialized ? chalk.green("Yes") : chalk.red("No"));
+      const dbExists = existsSync(dbPath);
+      console.log(chalk.white("Database:"), dbExists ? chalk.green("OK") : chalk.yellow("Not found"));
+      console.log(chalk.white("\nPaths:"));
+      console.log(chalk.gray(`  Project: ${cwd}`));
+      console.log(chalk.gray(`  KG Dir:  ${kgDir}`));
+      console.log(chalk.gray(`  DB:      ${dbPath}`));
+      const usage = process.memoryUsage();
+      console.log(chalk.white("\nMemory:"));
+      console.log(chalk.gray(`  Heap: ${formatBytes(usage.heapUsed)} / ${formatBytes(usage.heapTotal)}`));
+      console.log("");
+    } catch (error) {
+      console.error(chalk.red("Error getting status:"), error);
+      process.exit(1);
+    }
+  });
+  return diagnostics;
+}
+function printHealth(health) {
+  const statusColor = {
+    healthy: chalk.green,
+    degraded: chalk.yellow,
+    unhealthy: chalk.red,
+    unknown: chalk.gray
+  };
+  console.log(chalk.white("Overall Status:"), statusColor[health.status](health.status.toUpperCase()));
+  console.log(chalk.gray(`Uptime: ${Math.floor(health.uptime / 1e3)}s`));
+  console.log("");
+  console.log(chalk.white("Components:"));
+  for (const component of health.components) {
+    const icon = component.status === "healthy" ? "[OK]" : component.status === "degraded" ? "[!]" : "[X]";
+    const colorFn = statusColor[component.status];
+    console.log(
+      `  ${colorFn(icon)} ${component.name.padEnd(15)} ${colorFn(component.status)}`
+    );
+    if (component.message) {
+      console.log(chalk.gray(`    ${component.message}`));
+    }
+    if (component.responseTime !== void 0) {
+      console.log(chalk.gray(`    Response time: ${component.responseTime}ms`));
+    }
+  }
+  console.log("");
+}
+function formatBytes(bytes) {
+  if (bytes < 1024) return `${bytes} B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(2)} KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;
+}
+export {
+  createDiagnosticsCommand
+};
+//# sourceMappingURL=diagnostics.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sources":["../../../src/cli/commands/diagnostics.ts"],"sourcesContent":["/**\n * Diagnostics Command\n *\n * System diagnostics and health monitoring for knowledge graph.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport { join } from 'path';\nimport { existsSync } from 'fs';\nimport {\n  createHealthMonitor,\n  createDatabaseCheck,\n  createMemoryCheck,\n  createDiskCheck,\n} from '../../health/index.js';\nimport { createIntegrityChecker } from '../../recovery/index.js';\nimport type { SystemHealth, HealthStatus } from '../../health/index.js';\n\nexport function createDiagnosticsCommand(): Command {\n  const diagnostics = new Command('diagnostics')\n    .alias('diag')\n    .description('System diagnostics and health monitoring');\n\n  diagnostics\n    .command('health')\n    .description('Run health checks on all components')\n    .option('--json', 'Output as JSON')\n    .action(async (options) => {\n      try {\n        const cwd = process.cwd();\n        const dbPath = join(cwd, '.kg', 'knowledge.db');\n\n        const monitor = createHealthMonitor();\n\n        // Register health checks\n        monitor.register(createDatabaseCheck(dbPath));\n        monitor.register(createMemoryCheck(500));\n        monitor.register(createDiskCheck(cwd));\n\n        console.log(chalk.cyan('Running health checks...\\n'));\n\n        const health = await monitor.check();\n\n        if (options.json) {\n          console.log(JSON.stringify(health, null, 2));\n        } else {\n          printHealth(health);\n        }\n\n        if (health.status === 'unhealthy') {\n          process.exit(1);\n        }\n      } catch (error) {\n        console.error(chalk.red('Error running health checks:'), error);\n        process.exit(1);\n      }\n    });\n\n  diagnostics\n    .command('integrity')\n    .description('Check database integrity')\n    .option('--repair', 'Attempt to repair issues')\n    .action(async (options) => {\n      try {\n        const cwd = process.cwd();\n        const dbPath = join(cwd, '.kg', 'knowledge.db');\n\n        if (!existsSync(dbPath)) {\n          console.log(chalk.yellow('Database not found. Run \"kg init\" first.'));\n          process.exit(1);\n        }\n\n        console.log(chalk.cyan('Checking database integrity...\\n'));\n\n        const checker = createIntegrityChecker(dbPath);\n        const result = await checker.check();\n\n        if (result.valid) {\n          console.log(chalk.green('Database integrity: OK'));\n        } else {\n          console.log(chalk.red('Database integrity: FAILED'));\n          result.issues.forEach((issue: string) => {\n            console.log(chalk.yellow(`  - ${issue}`));\n          });\n\n          if (options.repair) {\n            console.log(chalk.cyan('\\nAttempting repairs...'));\n            const repairResult = await checker.repair();\n            if (repairResult.repaired) {\n              console.log(chalk.green('Repairs completed'));\n              repairResult.actions.forEach((action: string) => {\n                console.log(chalk.gray(`  - ${action}`));\n              });\n            } else {\n              console.log(chalk.red('Some repairs failed'));\n              process.exit(1);\n            }\n          }\n        }\n\n        console.log(chalk.gray(`\\nCheck completed in ${result.duration}ms`));\n      } catch (error) {\n        console.error(chalk.red('Error checking integrity:'), error);\n        process.exit(1);\n      }\n    });\n\n  diagnostics\n    .command('memory')\n    .description('Show memory usage statistics')\n    .action(() => {\n      const usage = process.memoryUsage();\n\n      console.log(chalk.cyan.bold('\\nMemory Usage:\\n'));\n      console.log(chalk.white(`  Heap Used:     ${formatBytes(usage.heapUsed)}`));\n      console.log(chalk.white(`  Heap Total:    ${formatBytes(usage.heapTotal)}`));\n      console.log(chalk.white(`  RSS:           ${formatBytes(usage.rss)}`));\n      console.log(chalk.white(`  External:      ${formatBytes(usage.external)}`));\n      console.log(chalk.white(`  Array Buffers: ${formatBytes(usage.arrayBuffers)}`));\n      console.log('');\n    });\n\n  diagnostics\n    .command('status')\n    .description('Show overall system status')\n    .action(async () => {\n      try {\n        const cwd = process.cwd();\n        const kgDir = join(cwd, '.kg');\n        const dbPath = join(kgDir, 'knowledge.db');\n\n        console.log(chalk.cyan.bold('\\nKnowledge Graph Status:\\n'));\n\n        // Check initialization\n        const initialized = existsSync(kgDir);\n        console.log(chalk.white('Initialized:'), initialized ? chalk.green('Yes') : chalk.red('No'));\n\n        // Check database\n        const dbExists = existsSync(dbPath);\n        console.log(chalk.white('Database:'), dbExists ? chalk.green('OK') : chalk.yellow('Not found'));\n\n        // Show paths\n        console.log(chalk.white('\\nPaths:'));\n        console.log(chalk.gray(`  Project: ${cwd}`));\n        console.log(chalk.gray(`  KG Dir:  ${kgDir}`));\n        console.log(chalk.gray(`  DB:      ${dbPath}`));\n\n        // Memory\n        const usage = process.memoryUsage();\n        console.log(chalk.white('\\nMemory:'));\n        console.log(chalk.gray(`  Heap: ${formatBytes(usage.heapUsed)} / ${formatBytes(usage.heapTotal)}`));\n\n        console.log('');\n      } catch (error) {\n        console.error(chalk.red('Error getting status:'), error);\n        process.exit(1);\n      }\n    });\n\n  return diagnostics;\n}\n\nfunction printHealth(health: SystemHealth): void {\n  const statusColor: Record<HealthStatus, typeof chalk.green> = {\n    healthy: chalk.green,\n    degraded: chalk.yellow,\n    unhealthy: chalk.red,\n    unknown: chalk.gray,\n  };\n\n  console.log(chalk.white('Overall Status:'), statusColor[health.status](health.status.toUpperCase()));\n  console.log(chalk.gray(`Uptime: ${Math.floor(health.uptime / 1000)}s`));\n  console.log('');\n\n  console.log(chalk.white('Components:'));\n  for (const component of health.components) {\n    const icon = component.status === 'healthy' ? '[OK]' : component.status === 'degraded' ? '[!]' : '[X]';\n    const colorFn = statusColor[component.status];\n    console.log(\n      `  ${colorFn(icon)} ${component.name.padEnd(15)} ${colorFn(component.status)}`\n    );\n    if (component.message) {\n      console.log(chalk.gray(`    ${component.message}`));\n    }\n    if (component.responseTime !== undefined) {\n      console.log(chalk.gray(`    Response time: ${component.responseTime}ms`));\n    }\n  }\n  console.log('');\n}\n\nfunction formatBytes(bytes: number): string {\n  if (bytes < 1024) return `${bytes} B`;\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(2)} KB`;\n  return `${(bytes / (1024 * 1024)).toFixed(2)} MB`;\n}\n"],"names":[],"mappings":"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"}

package/dist/cli/commands/generate.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Generate Command
+ *
+ * Generate or update knowledge graph from documentation.
+ *
+ * @module cli/commands/generate
+ */
+import { Command } from 'commander';
+/**
+ * Create the generate command
+ */
+export declare function createGenerateCommand(): Command;
+//# sourceMappingURL=generate.d.ts.map

package/dist/cli/commands/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,OAAO,CAkF/C"}

package/dist/cli/commands/init-primitives.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Init Primitives Command
+ *
+ * Bootstrap knowledge graph with primitive nodes from codebase analysis.
+ * Analyzes package.json, requirements.txt, Cargo.toml, go.mod, docker-compose,
+ * and other project files to generate foundational knowledge nodes.
+ *
+ * @module cli/commands/init-primitives
+ */
+import { Command } from 'commander';
+/**
+ * Create the init-primitives command
+ */
+export declare function createInitPrimitivesCommand(): Command;
+/**
+ * Create the analyze-codebase command (alias for analysis without generation)
+ */
+export declare function createAnalyzeCodebaseCommand(): Command;
+//# sourceMappingURL=init-primitives.d.ts.map

package/dist/cli/commands/init-primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-primitives.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init-primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,OAAO,CAsJrD;AAED;;GAEG;AACH,wBAAgB,4BAA4B,IAAI,OAAO,CAuGtD"}