@weavelogic/knowledge-graph-agent 0.1.0

package/dist/cli/commands/graph.js

@@ -0,0 +1,122 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { existsSync } from "fs";
+import { join } from "path";
+import { updateGraph, generateAndSave } from "../../generators/graph-generator.js";
+import { validateProjectRoot, validateDocsPath } from "../../core/security.js";
+function createGraphCommand() {
+  const command = new Command("graph");
+  command.description("Generate or update knowledge graph from documentation").option("-p, --path <path>", "Project root path", ".").option("-d, --docs <path>", "Docs directory path", "docs").option("-u, --update", "Incremental update instead of full regeneration").option("-v, --verbose", "Show detailed output").action(async (options) => {
+    const spinner = ora("Generating knowledge graph...").start();
+    try {
+      const projectRoot = validateProjectRoot(options.path);
+      const docsPath = validateDocsPath(projectRoot, options.docs);
+      const dbPath = join(projectRoot, ".kg", "knowledge.db");
+      if (!existsSync(docsPath)) {
+        spinner.fail(`Docs directory not found: ${docsPath}`);
+        console.log(chalk.gray("  Run ") + chalk.cyan("kg docs init") + chalk.gray(" to create it"));
+        process.exit(1);
+      }
+      if (!existsSync(join(projectRoot, ".kg"))) {
+        spinner.fail("Knowledge graph not initialized");
+        console.log(chalk.gray("  Run ") + chalk.cyan("kg init") + chalk.gray(" first"));
+        process.exit(1);
+      }
+      let result;
+      if (options.update && existsSync(dbPath)) {
+        spinner.text = "Updating knowledge graph...";
+        result = await updateGraph(dbPath, docsPath);
+        spinner.succeed("Knowledge graph updated!");
+        console.log();
+        console.log(chalk.white("  Changes:"));
+        console.log(chalk.green(`    Added:   ${result.added}`));
+        console.log(chalk.blue(`    Updated: ${result.updated}`));
+        console.log(chalk.yellow(`    Removed: ${result.removed}`));
+      } else {
+        spinner.text = "Scanning documentation...";
+        result = await generateAndSave(
+          {
+            projectRoot,
+            outputPath: docsPath
+          },
+          dbPath
+        );
+        if (result.success) {
+          spinner.succeed("Knowledge graph generated!");
+        } else {
+          spinner.warn("Knowledge graph generated with errors");
+        }
+        console.log();
+        console.log(chalk.white("  Statistics:"));
+        console.log(chalk.gray(`    Files scanned: ${result.stats.filesScanned}`));
+        console.log(chalk.green(`    Nodes created: ${result.stats.nodesCreated}`));
+        console.log(chalk.blue(`    Edges created: ${result.stats.edgesCreated}`));
+      }
+      const errors = "errors" in result ? result.errors : result.stats?.errors;
+      if (errors && errors.length > 0) {
+        console.log();
+        console.log(chalk.yellow("  Warnings:"));
+        errors.slice(0, 5).forEach((err) => {
+          console.log(chalk.gray(`    - ${err}`));
+        });
+        if (errors.length > 5) {
+          console.log(chalk.gray(`    ... and ${errors.length - 5} more`));
+        }
+      }
+      console.log();
+      console.log(chalk.cyan("Next: ") + chalk.white("kg stats") + chalk.gray(" to view graph statistics"));
+      console.log();
+    } catch (error) {
+      spinner.fail("Failed to generate knowledge graph");
+      console.error(chalk.red(String(error)));
+      process.exit(1);
+    }
+  });
+  command.command("analyze").description("Analyze graph structure and suggest improvements").option("-p, --path <path>", "Project root path", ".").action(async (options) => {
+    const spinner = ora("Analyzing graph...").start();
+    try {
+      const projectRoot = validateProjectRoot(options.path);
+      const dbPath = join(projectRoot, ".kg", "knowledge.db");
+      if (!existsSync(dbPath)) {
+        spinner.fail('Knowledge graph not found. Run "kg graph" first.');
+        process.exit(1);
+      }
+      const { createDatabase } = await import("../../core/database.js");
+      const db = createDatabase(dbPath);
+      const stats = db.getStats();
+      spinner.succeed("Graph analysis complete!");
+      console.log();
+      console.log(chalk.white("  Graph Health:"));
+      if (stats.orphanNodes > 0) {
+        console.log(chalk.yellow(`    ⚠ ${stats.orphanNodes} orphan nodes (no links)`));
+      } else {
+        console.log(chalk.green("    ✓ No orphan nodes"));
+      }
+      const density = stats.avgLinksPerNode;
+      if (density < 1) {
+        console.log(chalk.yellow(`    ⚠ Low link density (${density} avg links/node)`));
+      } else {
+        console.log(chalk.green(`    ✓ Good link density (${density} avg links/node)`));
+      }
+      if (stats.mostConnected.length > 0) {
+        console.log();
+        console.log(chalk.white("  Most Connected:"));
+        stats.mostConnected.forEach(({ id, connections }) => {
+          console.log(chalk.gray(`    ${id}: ${connections} connections`));
+        });
+      }
+      db.close();
+      console.log();
+    } catch (error) {
+      spinner.fail("Analysis failed");
+      console.error(chalk.red(String(error)));
+      process.exit(1);
+    }
+  });
+  return command;
+}
+export {
+  createGraphCommand
+};
+//# sourceMappingURL=graph.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph.js","sources":["../../../src/cli/commands/graph.ts"],"sourcesContent":["/**\n * Graph Command\n *\n * Generate and update knowledge graph from documentation.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport { existsSync } from 'fs';\nimport { join } from 'path';\nimport { generateAndSave, updateGraph } from '../../generators/graph-generator.js';\nimport { validateProjectRoot, validateDocsPath } from '../../core/security.js';\n\n/**\n * Create graph command\n */\nexport function createGraphCommand(): Command {\n  const command = new Command('graph');\n\n  command\n    .description('Generate or update knowledge graph from documentation')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-d, --docs <path>', 'Docs directory path', 'docs')\n    .option('-u, --update', 'Incremental update instead of full regeneration')\n    .option('-v, --verbose', 'Show detailed output')\n    .action(async (options) => {\n      const spinner = ora('Generating knowledge graph...').start();\n\n      try {\n        // Validate paths to prevent traversal attacks\n        const projectRoot = validateProjectRoot(options.path);\n        const docsPath = validateDocsPath(projectRoot, options.docs);\n        const dbPath = join(projectRoot, '.kg', 'knowledge.db');\n\n        // Check if docs exist\n        if (!existsSync(docsPath)) {\n          spinner.fail(`Docs directory not found: ${docsPath}`);\n          console.log(chalk.gray('  Run ') + chalk.cyan('kg docs init') + chalk.gray(' to create it'));\n          process.exit(1);\n        }\n\n        // Check if KG is initialized\n        if (!existsSync(join(projectRoot, '.kg'))) {\n          spinner.fail('Knowledge graph not initialized');\n          console.log(chalk.gray('  Run ') + chalk.cyan('kg init') + chalk.gray(' first'));\n          process.exit(1);\n        }\n\n        let result;\n\n        if (options.update && existsSync(dbPath)) {\n          // Incremental update\n          spinner.text = 'Updating knowledge graph...';\n          result = await updateGraph(dbPath, docsPath);\n\n          spinner.succeed('Knowledge graph updated!');\n\n          console.log();\n          console.log(chalk.white('  Changes:'));\n          console.log(chalk.green(`    Added:   ${result.added}`));\n          console.log(chalk.blue(`    Updated: ${result.updated}`));\n          console.log(chalk.yellow(`    Removed: ${result.removed}`));\n\n        } else {\n          // Full generation\n          spinner.text = 'Scanning documentation...';\n\n          result = await generateAndSave(\n            {\n              projectRoot,\n              outputPath: docsPath,\n            },\n            dbPath\n          );\n\n          if (result.success) {\n            spinner.succeed('Knowledge graph generated!');\n          } else {\n            spinner.warn('Knowledge graph generated with errors');\n          }\n\n          console.log();\n          console.log(chalk.white('  Statistics:'));\n          console.log(chalk.gray(`    Files scanned: ${result.stats.filesScanned}`));\n          console.log(chalk.green(`    Nodes created: ${result.stats.nodesCreated}`));\n          console.log(chalk.blue(`    Edges created: ${result.stats.edgesCreated}`));\n        }\n\n        // Show errors if any\n        const errors = 'errors' in result ? result.errors : result.stats?.errors;\n        if (errors && errors.length > 0) {\n          console.log();\n          console.log(chalk.yellow('  Warnings:'));\n          errors.slice(0, 5).forEach((err: string) => {\n            console.log(chalk.gray(`    - ${err}`));\n          });\n          if (errors.length > 5) {\n            console.log(chalk.gray(`    ... and ${errors.length - 5} more`));\n          }\n        }\n\n        console.log();\n        console.log(chalk.cyan('Next: ') + chalk.white('kg stats') + chalk.gray(' to view graph statistics'));\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Failed to generate knowledge graph');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  // Add subcommands\n  command\n    .command('analyze')\n    .description('Analyze graph structure and suggest improvements')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .action(async (options) => {\n      const spinner = ora('Analyzing graph...').start();\n\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n        const dbPath = join(projectRoot, '.kg', 'knowledge.db');\n\n        if (!existsSync(dbPath)) {\n          spinner.fail('Knowledge graph not found. Run \"kg graph\" first.');\n          process.exit(1);\n        }\n\n        const { createDatabase } = await import('../../core/database.js');\n        const db = createDatabase(dbPath);\n\n        const stats = db.getStats();\n        spinner.succeed('Graph analysis complete!');\n\n        console.log();\n        console.log(chalk.white('  Graph Health:'));\n\n        // Orphan analysis\n        if (stats.orphanNodes > 0) {\n          console.log(chalk.yellow(`    ⚠ ${stats.orphanNodes} orphan nodes (no links)`));\n        } else {\n          console.log(chalk.green('    ✓ No orphan nodes'));\n        }\n\n        // Connection density\n        const density = stats.avgLinksPerNode;\n        if (density < 1) {\n          console.log(chalk.yellow(`    ⚠ Low link density (${density} avg links/node)`));\n        } else {\n          console.log(chalk.green(`    ✓ Good link density (${density} avg links/node)`));\n        }\n\n        // Most connected nodes\n        if (stats.mostConnected.length > 0) {\n          console.log();\n          console.log(chalk.white('  Most Connected:'));\n          stats.mostConnected.forEach(({ id, connections }) => {\n            console.log(chalk.gray(`    ${id}: ${connections} connections`));\n          });\n        }\n\n        db.close();\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  return command;\n}\n"],"names":[],"mappings":";;;;;;;AAiBO,SAAS,qBAA8B;AAC5C,QAAM,UAAU,IAAI,QAAQ,OAAO;AAEnC,UACG,YAAY,uDAAuD,EACnE,OAAO,qBAAqB,qBAAqB,GAAG,EACpD,OAAO,qBAAqB,uBAAuB,MAAM,EACzD,OAAO,gBAAgB,iDAAiD,EACxE,OAAO,iBAAiB,sBAAsB,EAC9C,OAAO,OAAO,YAAY;AACzB,UAAM,UAAU,IAAI,+BAA+B,EAAE,MAAA;AAErD,QAAI;AAEF,YAAM,cAAc,oBAAoB,QAAQ,IAAI;AACpD,YAAM,WAAW,iBAAiB,aAAa,QAAQ,IAAI;AAC3D,YAAM,SAAS,KAAK,aAAa,OAAO,cAAc;AAGtD,UAAI,CAAC,WAAW,QAAQ,GAAG;AACzB,gBAAQ,KAAK,6BAA6B,QAAQ,EAAE;AACpD,gBAAQ,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,cAAc,IAAI,MAAM,KAAK,eAAe,CAAC;AAC3F,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAGA,UAAI,CAAC,WAAW,KAAK,aAAa,KAAK,CAAC,GAAG;AACzC,gBAAQ,KAAK,iCAAiC;AAC9C,gBAAQ,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,QAAQ,CAAC;AAC/E,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAEA,UAAI;AAEJ,UAAI,QAAQ,UAAU,WAAW,MAAM,GAAG;AAExC,gBAAQ,OAAO;AACf,iBAAS,MAAM,YAAY,QAAQ,QAAQ;AAE3C,gBAAQ,QAAQ,0BAA0B;AAE1C,gBAAQ,IAAA;AACR,gBAAQ,IAAI,MAAM,MAAM,YAAY,CAAC;AACrC,gBAAQ,IAAI,MAAM,MAAM,gBAAgB,OAAO,KAAK,EAAE,CAAC;AACvD,gBAAQ,IAAI,MAAM,KAAK,gBAAgB,OAAO,OAAO,EAAE,CAAC;AACxD,gBAAQ,IAAI,MAAM,OAAO,gBAAgB,OAAO,OAAO,EAAE,CAAC;AAAA,MAE5D,OAAO;AAEL,gBAAQ,OAAO;AAEf,iBAAS,MAAM;AAAA,UACb;AAAA,YACE;AAAA,YACA,YAAY;AAAA,UAAA;AAAA,UAEd;AAAA,QAAA;AAGF,YAAI,OAAO,SAAS;AAClB,kBAAQ,QAAQ,4BAA4B;AAAA,QAC9C,OAAO;AACL,kBAAQ,KAAK,uCAAuC;AAAA,QACtD;AAEA,gBAAQ,IAAA;AACR,gBAAQ,IAAI,MAAM,MAAM,eAAe,CAAC;AACxC,gBAAQ,IAAI,MAAM,KAAK,sBAAsB,OAAO,MAAM,YAAY,EAAE,CAAC;AACzE,gBAAQ,IAAI,MAAM,MAAM,sBAAsB,OAAO,MAAM,YAAY,EAAE,CAAC;AAC1E,gBAAQ,IAAI,MAAM,KAAK,sBAAsB,OAAO,MAAM,YAAY,EAAE,CAAC;AAAA,MAC3E;AAGA,YAAM,SAAS,YAAY,SAAS,OAAO,SAAS,OAAO,OAAO;AAClE,UAAI,UAAU,OAAO,SAAS,GAAG;AAC/B,gBAAQ,IAAA;AACR,gBAAQ,IAAI,MAAM,OAAO,aAAa,CAAC;AACvC,eAAO,MAAM,GAAG,CAAC,EAAE,QAAQ,CAAC,QAAgB;AAC1C,kBAAQ,IAAI,MAAM,KAAK,SAAS,GAAG,EAAE,CAAC;AAAA,QACxC,CAAC;AACD,YAAI,OAAO,SAAS,GAAG;AACrB,kBAAQ,IAAI,MAAM,KAAK,eAAe,OAAO,SAAS,CAAC,OAAO,CAAC;AAAA,QACjE;AAAA,MACF;AAEA,cAAQ,IAAA;AACR,cAAQ,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,MAAM,UAAU,IAAI,MAAM,KAAK,2BAA2B,CAAC;AACpG,cAAQ,IAAA;AAAA,IAEV,SAAS,OAAO;AACd,cAAQ,KAAK,oCAAoC;AACjD,cAAQ,MAAM,MAAM,IAAI,OAAO,KAAK,CAAC,CAAC;AACtC,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,CAAC;AAGH,UACG,QAAQ,SAAS,EACjB,YAAY,kDAAkD,EAC9D,OAAO,qBAAqB,qBAAqB,GAAG,EACpD,OAAO,OAAO,YAAY;AACzB,UAAM,UAAU,IAAI,oBAAoB,EAAE,MAAA;AAE1C,QAAI;AACF,YAAM,cAAc,oBAAoB,QAAQ,IAAI;AACpD,YAAM,SAAS,KAAK,aAAa,OAAO,cAAc;AAEtD,UAAI,CAAC,WAAW,MAAM,GAAG;AACvB,gBAAQ,KAAK,kDAAkD;AAC/D,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAEA,YAAM,EAAE,eAAA,IAAmB,MAAM,OAAO,wBAAwB;AAChE,YAAM,KAAK,eAAe,MAAM;AAEhC,YAAM,QAAQ,GAAG,SAAA;AACjB,cAAQ,QAAQ,0BAA0B;AAE1C,cAAQ,IAAA;AACR,cAAQ,IAAI,MAAM,MAAM,iBAAiB,CAAC;AAG1C,UAAI,MAAM,cAAc,GAAG;AACzB,gBAAQ,IAAI,MAAM,OAAO,SAAS,MAAM,WAAW,0BAA0B,CAAC;AAAA,MAChF,OAAO;AACL,gBAAQ,IAAI,MAAM,MAAM,uBAAuB,CAAC;AAAA,MAClD;AAGA,YAAM,UAAU,MAAM;AACtB,UAAI,UAAU,GAAG;AACf,gBAAQ,IAAI,MAAM,OAAO,2BAA2B,OAAO,kBAAkB,CAAC;AAAA,MAChF,OAAO;AACL,gBAAQ,IAAI,MAAM,MAAM,4BAA4B,OAAO,kBAAkB,CAAC;AAAA,MAChF;AAGA,UAAI,MAAM,cAAc,SAAS,GAAG;AAClC,gBAAQ,IAAA;AACR,gBAAQ,IAAI,MAAM,MAAM,mBAAmB,CAAC;AAC5C,cAAM,cAAc,QAAQ,CAAC,EAAE,IAAI,kBAAkB;AACnD,kBAAQ,IAAI,MAAM,KAAK,OAAO,EAAE,KAAK,WAAW,cAAc,CAAC;AAAA,QACjE,CAAC;AAAA,MACH;AAEA,SAAG,MAAA;AACH,cAAQ,IAAA;AAAA,IAEV,SAAS,OAAO;AACd,cAAQ,KAAK,iBAAiB;AAC9B,cAAQ,MAAM,MAAM,IAAI,OAAO,KAAK,CAAC,CAAC;AACtC,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,CAAC;AAEH,SAAO;AACT;"}

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

@@ -0,0 +1,11 @@
+/**
+ * Init Command
+ *
+ * Initialize knowledge graph in a project.
+ */
+import { Command } from 'commander';
+/**
+ * Create init command
+ */
+export declare function createInitCommand(): Command;
+//# sourceMappingURL=init.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAkG3C"}

package/dist/cli/commands/init.js

@@ -0,0 +1,80 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { join } from "path";
+import { ConfigSchema } from "../../core/types.js";
+import { createDatabase } from "../../core/database.js";
+import { validateProjectRoot, validateDocsPath } from "../../core/security.js";
+function createInitCommand() {
+  const command = new Command("init");
+  command.description("Initialize knowledge graph in the current project").option("-p, --path <path>", "Project root path", ".").option("-d, --docs <path>", "Docs directory path", "docs").option("-n, --name <name>", "Project name").option("--no-db", "Skip database initialization").option("--no-config", "Skip config file creation").option("-f, --force", "Overwrite existing files").action(async (options) => {
+    const spinner = ora("Initializing knowledge graph...").start();
+    try {
+      const projectRoot = validateProjectRoot(options.path);
+      const docsPath = options.docs;
+      validateDocsPath(projectRoot, docsPath);
+      const kgDir = join(projectRoot, ".kg");
+      if (existsSync(kgDir) && !options.force) {
+        spinner.warn("Knowledge graph already initialized. Use --force to reinitialize.");
+        return;
+      }
+      if (!existsSync(kgDir)) {
+        mkdirSync(kgDir, { recursive: true });
+      }
+      if (options.db !== false) {
+        spinner.text = "Creating database...";
+        const dbPath = join(kgDir, "knowledge.db");
+        const db = createDatabase(dbPath);
+        db.setMetadata("projectRoot", projectRoot);
+        db.setMetadata("docsPath", docsPath);
+        db.setMetadata("initialized", (/* @__PURE__ */ new Date()).toISOString());
+        db.close();
+      }
+      if (options.config !== false) {
+        spinner.text = "Creating configuration...";
+        const configPath = join(kgDir, "config.json");
+        if (!existsSync(configPath) || options.force) {
+          const config = ConfigSchema.parse({
+            projectRoot: ".",
+            docsRoot: docsPath,
+            vaultName: options.name,
+            graph: {
+              includePatterns: ["**/*.md"],
+              excludePatterns: ["node_modules/**", "dist/**", ".git/**"]
+            },
+            database: {
+              path: ".kg/knowledge.db"
+            },
+            claudeFlow: {
+              enabled: true,
+              namespace: "knowledge-graph",
+              syncOnChange: true
+            }
+          });
+          writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
+        }
+      }
+      const gitignorePath = join(kgDir, ".gitignore");
+      if (!existsSync(gitignorePath)) {
+        writeFileSync(gitignorePath, "# Knowledge Graph Database\nknowledge.db\nknowledge.db-wal\nknowledge.db-shm\n", "utf-8");
+      }
+      spinner.succeed("Knowledge graph initialized!");
+      console.log("\n" + chalk.cyan("Next steps:"));
+      console.log(chalk.gray("  1. Initialize docs:    ") + chalk.white("kg docs init"));
+      console.log(chalk.gray("  2. Generate graph:     ") + chalk.white("kg graph"));
+      console.log(chalk.gray("  3. Update CLAUDE.md:   ") + chalk.white("kg claude update"));
+      console.log(chalk.gray("  4. Sync with claude-flow: ") + chalk.white("kg sync"));
+      console.log();
+    } catch (error) {
+      spinner.fail("Failed to initialize knowledge graph");
+      console.error(chalk.red(String(error)));
+      process.exit(1);
+    }
+  });
+  return command;
+}
+export {
+  createInitCommand
+};
+//# sourceMappingURL=init.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sources":["../../../src/cli/commands/init.ts"],"sourcesContent":["/**\n * Init Command\n *\n * Initialize knowledge graph in a project.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport { existsSync, mkdirSync, writeFileSync } from 'fs';\nimport { join } from 'path';\nimport { ConfigSchema } from '../../core/types.js';\nimport { createDatabase } from '../../core/database.js';\nimport { validateProjectRoot, validateDocsPath } from '../../core/security.js';\n\n/**\n * Create init command\n */\nexport function createInitCommand(): Command {\n  const command = new Command('init');\n\n  command\n    .description('Initialize knowledge graph in the current project')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-d, --docs <path>', 'Docs directory path', 'docs')\n    .option('-n, --name <name>', 'Project name')\n    .option('--no-db', 'Skip database initialization')\n    .option('--no-config', 'Skip config file creation')\n    .option('-f, --force', 'Overwrite existing files')\n    .action(async (options) => {\n      const spinner = ora('Initializing knowledge graph...').start();\n\n      try {\n        // Validate paths to prevent traversal attacks\n        const projectRoot = validateProjectRoot(options.path);\n        const docsPath = options.docs; // Relative path for config, validated when used\n        validateDocsPath(projectRoot, docsPath); // Validate it stays within project\n        const kgDir = join(projectRoot, '.kg');\n\n        // Check if already initialized\n        if (existsSync(kgDir) && !options.force) {\n          spinner.warn('Knowledge graph already initialized. Use --force to reinitialize.');\n          return;\n        }\n\n        // Create .kg directory\n        if (!existsSync(kgDir)) {\n          mkdirSync(kgDir, { recursive: true });\n        }\n\n        // Initialize database\n        if (options.db !== false) {\n          spinner.text = 'Creating database...';\n          const dbPath = join(kgDir, 'knowledge.db');\n          const db = createDatabase(dbPath);\n\n          // Set initial metadata\n          db.setMetadata('projectRoot', projectRoot);\n          db.setMetadata('docsPath', docsPath);\n          db.setMetadata('initialized', new Date().toISOString());\n\n          db.close();\n        }\n\n        // Create config file\n        if (options.config !== false) {\n          spinner.text = 'Creating configuration...';\n          const configPath = join(kgDir, 'config.json');\n\n          if (!existsSync(configPath) || options.force) {\n            const config = ConfigSchema.parse({\n              projectRoot: '.',\n              docsRoot: docsPath,\n              vaultName: options.name,\n              graph: {\n                includePatterns: ['**/*.md'],\n                excludePatterns: ['node_modules/**', 'dist/**', '.git/**'],\n              },\n              database: {\n                path: '.kg/knowledge.db',\n              },\n              claudeFlow: {\n                enabled: true,\n                namespace: 'knowledge-graph',\n                syncOnChange: true,\n              },\n            });\n\n            writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');\n          }\n        }\n\n        // Create .gitignore entry\n        const gitignorePath = join(kgDir, '.gitignore');\n        if (!existsSync(gitignorePath)) {\n          writeFileSync(gitignorePath, '# Knowledge Graph Database\\nknowledge.db\\nknowledge.db-wal\\nknowledge.db-shm\\n', 'utf-8');\n        }\n\n        spinner.succeed('Knowledge graph initialized!');\n\n        // Show next steps\n        console.log('\\n' + chalk.cyan('Next steps:'));\n        console.log(chalk.gray('  1. Initialize docs:    ') + chalk.white('kg docs init'));\n        console.log(chalk.gray('  2. Generate graph:     ') + chalk.white('kg graph'));\n        console.log(chalk.gray('  3. Update CLAUDE.md:   ') + chalk.white('kg claude update'));\n        console.log(chalk.gray('  4. Sync with claude-flow: ') + chalk.white('kg sync'));\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Failed to initialize knowledge graph');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  return command;\n}\n"],"names":[],"mappings":";;;;;;;;AAkBO,SAAS,oBAA6B;AAC3C,QAAM,UAAU,IAAI,QAAQ,MAAM;AAElC,UACG,YAAY,mDAAmD,EAC/D,OAAO,qBAAqB,qBAAqB,GAAG,EACpD,OAAO,qBAAqB,uBAAuB,MAAM,EACzD,OAAO,qBAAqB,cAAc,EAC1C,OAAO,WAAW,8BAA8B,EAChD,OAAO,eAAe,2BAA2B,EACjD,OAAO,eAAe,0BAA0B,EAChD,OAAO,OAAO,YAAY;AACzB,UAAM,UAAU,IAAI,iCAAiC,EAAE,MAAA;AAEvD,QAAI;AAEF,YAAM,cAAc,oBAAoB,QAAQ,IAAI;AACpD,YAAM,WAAW,QAAQ;AACzB,uBAAiB,aAAa,QAAQ;AACtC,YAAM,QAAQ,KAAK,aAAa,KAAK;AAGrC,UAAI,WAAW,KAAK,KAAK,CAAC,QAAQ,OAAO;AACvC,gBAAQ,KAAK,mEAAmE;AAChF;AAAA,MACF;AAGA,UAAI,CAAC,WAAW,KAAK,GAAG;AACtB,kBAAU,OAAO,EAAE,WAAW,KAAA,CAAM;AAAA,MACtC;AAGA,UAAI,QAAQ,OAAO,OAAO;AACxB,gBAAQ,OAAO;AACf,cAAM,SAAS,KAAK,OAAO,cAAc;AACzC,cAAM,KAAK,eAAe,MAAM;AAGhC,WAAG,YAAY,eAAe,WAAW;AACzC,WAAG,YAAY,YAAY,QAAQ;AACnC,WAAG,YAAY,gBAAe,oBAAI,KAAA,GAAO,aAAa;AAEtD,WAAG,MAAA;AAAA,MACL;AAGA,UAAI,QAAQ,WAAW,OAAO;AAC5B,gBAAQ,OAAO;AACf,cAAM,aAAa,KAAK,OAAO,aAAa;AAE5C,YAAI,CAAC,WAAW,UAAU,KAAK,QAAQ,OAAO;AAC5C,gBAAM,SAAS,aAAa,MAAM;AAAA,YAChC,aAAa;AAAA,YACb,UAAU;AAAA,YACV,WAAW,QAAQ;AAAA,YACnB,OAAO;AAAA,cACL,iBAAiB,CAAC,SAAS;AAAA,cAC3B,iBAAiB,CAAC,mBAAmB,WAAW,SAAS;AAAA,YAAA;AAAA,YAE3D,UAAU;AAAA,cACR,MAAM;AAAA,YAAA;AAAA,YAER,YAAY;AAAA,cACV,SAAS;AAAA,cACT,WAAW;AAAA,cACX,cAAc;AAAA,YAAA;AAAA,UAChB,CACD;AAED,wBAAc,YAAY,KAAK,UAAU,QAAQ,MAAM,CAAC,GAAG,OAAO;AAAA,QACpE;AAAA,MACF;AAGA,YAAM,gBAAgB,KAAK,OAAO,YAAY;AAC9C,UAAI,CAAC,WAAW,aAAa,GAAG;AAC9B,sBAAc,eAAe,kFAAkF,OAAO;AAAA,MACxH;AAEA,cAAQ,QAAQ,8BAA8B;AAG9C,cAAQ,IAAI,OAAO,MAAM,KAAK,aAAa,CAAC;AAC5C,cAAQ,IAAI,MAAM,KAAK,2BAA2B,IAAI,MAAM,MAAM,cAAc,CAAC;AACjF,cAAQ,IAAI,MAAM,KAAK,2BAA2B,IAAI,MAAM,MAAM,UAAU,CAAC;AAC7E,cAAQ,IAAI,MAAM,KAAK,2BAA2B,IAAI,MAAM,MAAM,kBAAkB,CAAC;AACrF,cAAQ,IAAI,MAAM,KAAK,8BAA8B,IAAI,MAAM,MAAM,SAAS,CAAC;AAC/E,cAAQ,IAAA;AAAA,IAEV,SAAS,OAAO;AACd,cAAQ,KAAK,sCAAsC;AACnD,cAAQ,MAAM,MAAM,IAAI,OAAO,KAAK,CAAC,CAAC;AACtC,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,CAAC;AAEH,SAAO;AACT;"}

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

@@ -0,0 +1,11 @@
+/**
+ * Search Command
+ *
+ * Search the knowledge graph.
+ */
+import { Command } from 'commander';
+/**
+ * Create search command
+ */
+export declare function createSearchCommand(): Command;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAuG7C"}

package/dist/cli/commands/search.js

@@ -0,0 +1,80 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import { existsSync } from "fs";
+import { join } from "path";
+import { createDatabase } from "../../core/database.js";
+import { validateProjectRoot } from "../../core/security.js";
+function createSearchCommand() {
+  const command = new Command("search");
+  command.description("Search the knowledge graph").argument("<query>", "Search query").option("-p, --path <path>", "Project root path", ".").option("-t, --type <type>", "Filter by node type").option("-g, --tag <tag>", "Filter by tag").option("-l, --limit <number>", "Limit results", "20").option("--json", "Output as JSON").action(async (query, options) => {
+    try {
+      const projectRoot = validateProjectRoot(options.path);
+      const dbPath = join(projectRoot, ".kg", "knowledge.db");
+      if (!existsSync(dbPath)) {
+        console.log(chalk.yellow("  Knowledge graph not found"));
+        console.log(chalk.gray("  Run ") + chalk.cyan("kg graph") + chalk.gray(" to generate one"));
+        return;
+      }
+      const db = createDatabase(dbPath);
+      const limit = parseInt(options.limit, 10);
+      let results;
+      if (options.tag) {
+        results = db.getNodesByTag(options.tag);
+      } else if (options.type) {
+        results = db.getNodesByType(options.type);
+      } else {
+        results = db.searchNodes(query, limit);
+      }
+      if (options.type && !options.tag) {
+        results = results.filter((n) => n.type === options.type);
+      }
+      results = results.slice(0, limit);
+      if (options.json) {
+        console.log(JSON.stringify(results.map((n) => ({
+          id: n.id,
+          title: n.title,
+          type: n.type,
+          status: n.status,
+          path: n.path,
+          tags: n.tags
+        })), null, 2));
+        db.close();
+        return;
+      }
+      console.log(chalk.cyan(`
+  Search Results for "${query}"
+`));
+      if (results.length === 0) {
+        console.log(chalk.gray("  No results found"));
+        db.close();
+        return;
+      }
+      console.log(chalk.gray(`  Found ${results.length} result${results.length === 1 ? "" : "s"}
+`));
+      results.forEach((node, i) => {
+        const statusColor = node.status === "active" ? chalk.green : node.status === "draft" ? chalk.yellow : node.status === "deprecated" ? chalk.red : chalk.gray;
+        console.log(chalk.white(`  ${i + 1}. ${node.title}`));
+        console.log(chalk.gray(`     Type: ${node.type} | Status: `) + statusColor(node.status));
+        console.log(chalk.gray(`     Path: ${node.path}`));
+        if (node.tags.length > 0) {
+          console.log(chalk.gray("     Tags: ") + chalk.blue(node.tags.join(", ")));
+        }
+        const incoming = node.incomingLinks.length;
+        const outgoing = node.outgoingLinks.length;
+        if (incoming > 0 || outgoing > 0) {
+          console.log(chalk.gray(`     Links: ${incoming} incoming, ${outgoing} outgoing`));
+        }
+        console.log();
+      });
+      db.close();
+    } catch (error) {
+      console.error(chalk.red("Search failed:"), String(error));
+      process.exit(1);
+    }
+  });
+  return command;
+}
+export {
+  createSearchCommand
+};
+//# sourceMappingURL=search.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sources":["../../../src/cli/commands/search.ts"],"sourcesContent":["/**\n * Search Command\n *\n * Search the knowledge graph.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport { existsSync } from 'fs';\nimport { join } from 'path';\nimport { createDatabase } from '../../core/database.js';\nimport { validateProjectRoot } from '../../core/security.js';\n\n/**\n * Create search command\n */\nexport function createSearchCommand(): Command {\n  const command = new Command('search');\n\n  command\n    .description('Search the knowledge graph')\n    .argument('<query>', 'Search query')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-t, --type <type>', 'Filter by node type')\n    .option('-g, --tag <tag>', 'Filter by tag')\n    .option('-l, --limit <number>', 'Limit results', '20')\n    .option('--json', 'Output as JSON')\n    .action(async (query, options) => {\n      try {\n        // Validate path to prevent traversal attacks\n        const projectRoot = validateProjectRoot(options.path);\n        const dbPath = join(projectRoot, '.kg', 'knowledge.db');\n\n        // Check if database exists\n        if (!existsSync(dbPath)) {\n          console.log(chalk.yellow('  Knowledge graph not found'));\n          console.log(chalk.gray('  Run ') + chalk.cyan('kg graph') + chalk.gray(' to generate one'));\n          return;\n        }\n\n        const db = createDatabase(dbPath);\n        const limit = parseInt(options.limit, 10);\n\n        let results;\n\n        if (options.tag) {\n          // Search by tag\n          results = db.getNodesByTag(options.tag);\n        } else if (options.type) {\n          // Search by type\n          results = db.getNodesByType(options.type);\n        } else {\n          // Full-text search\n          results = db.searchNodes(query, limit);\n        }\n\n        // Apply additional filters\n        if (options.type && !options.tag) {\n          results = results.filter(n => n.type === options.type);\n        }\n\n        // Limit results\n        results = results.slice(0, limit);\n\n        if (options.json) {\n          console.log(JSON.stringify(results.map(n => ({\n            id: n.id,\n            title: n.title,\n            type: n.type,\n            status: n.status,\n            path: n.path,\n            tags: n.tags,\n          })), null, 2));\n          db.close();\n          return;\n        }\n\n        console.log(chalk.cyan(`\\n  Search Results for \"${query}\"\\n`));\n\n        if (results.length === 0) {\n          console.log(chalk.gray('  No results found'));\n          db.close();\n          return;\n        }\n\n        console.log(chalk.gray(`  Found ${results.length} result${results.length === 1 ? '' : 's'}\\n`));\n\n        results.forEach((node, i) => {\n          const statusColor = node.status === 'active' ? chalk.green :\n                             node.status === 'draft' ? chalk.yellow :\n                             node.status === 'deprecated' ? chalk.red : chalk.gray;\n\n          console.log(chalk.white(`  ${i + 1}. ${node.title}`));\n          console.log(chalk.gray(`     Type: ${node.type} | Status: `) + statusColor(node.status));\n          console.log(chalk.gray(`     Path: ${node.path}`));\n\n          if (node.tags.length > 0) {\n            console.log(chalk.gray('     Tags: ') + chalk.blue(node.tags.join(', ')));\n          }\n\n          // Show connections\n          const incoming = node.incomingLinks.length;\n          const outgoing = node.outgoingLinks.length;\n          if (incoming > 0 || outgoing > 0) {\n            console.log(chalk.gray(`     Links: ${incoming} incoming, ${outgoing} outgoing`));\n          }\n\n          console.log();\n        });\n\n        db.close();\n\n      } catch (error) {\n        console.error(chalk.red('Search failed:'), String(error));\n        process.exit(1);\n      }\n    });\n\n  return command;\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,11 @@
+/**
+ * Stats Command
+ *
+ * Display knowledge graph statistics.
+ */
+import { Command } from 'commander';
+/**
+ * Create stats command
+ */
+export declare function createStatsCommand(): Command;
+//# sourceMappingURL=stats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/stats.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAmG5C"}

package/dist/cli/commands/stats.js

@@ -0,0 +1,84 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import { existsSync } from "fs";
+import { join } from "path";
+import { createDatabase } from "../../core/database.js";
+import { validateProjectRoot } from "../../core/security.js";
+function createStatsCommand() {
+  const command = new Command("stats");
+  command.description("Display knowledge graph statistics").option("-p, --path <path>", "Project root path", ".").option("--json", "Output as JSON").action(async (options) => {
+    try {
+      const projectRoot = validateProjectRoot(options.path);
+      const dbPath = join(projectRoot, ".kg", "knowledge.db");
+      if (!existsSync(dbPath)) {
+        console.log(chalk.yellow("  Knowledge graph not found"));
+        console.log(chalk.gray("  Run ") + chalk.cyan("kg graph") + chalk.gray(" to generate one"));
+        return;
+      }
+      const db = createDatabase(dbPath);
+      const stats = db.getStats();
+      const metadata = {
+        version: db.getMetadata("version"),
+        lastGenerated: db.getMetadata("lastGenerated"),
+        lastUpdated: db.getMetadata("lastUpdated")
+      };
+      if (options.json) {
+        console.log(JSON.stringify({ stats, metadata }, null, 2));
+        db.close();
+        return;
+      }
+      console.log(chalk.cyan("\n  Knowledge Graph Statistics\n"));
+      console.log(chalk.white("  Overview"));
+      console.log(chalk.gray(`    Total nodes:  ${stats.totalNodes}`));
+      console.log(chalk.gray(`    Total edges:  ${stats.totalEdges}`));
+      console.log(chalk.gray(`    Orphan nodes: ${stats.orphanNodes}`));
+      console.log(chalk.gray(`    Avg links:    ${stats.avgLinksPerNode}/node`));
+      console.log();
+      console.log(chalk.white("  Nodes by Type"));
+      Object.entries(stats.nodesByType).forEach(([type, count]) => {
+        if (count > 0) {
+          const bar = "█".repeat(Math.min(count, 20));
+          console.log(chalk.gray(`    ${type.padEnd(12)} ${String(count).padStart(4)} ${chalk.blue(bar)}`));
+        }
+      });
+      console.log();
+      console.log(chalk.white("  Nodes by Status"));
+      Object.entries(stats.nodesByStatus).forEach(([status, count]) => {
+        if (count > 0) {
+          const color = status === "active" ? chalk.green : status === "draft" ? chalk.yellow : status === "deprecated" ? chalk.red : chalk.gray;
+          console.log(color(`    ${status.padEnd(12)} ${count}`));
+        }
+      });
+      if (stats.mostConnected.length > 0) {
+        console.log();
+        console.log(chalk.white("  Most Connected Nodes"));
+        stats.mostConnected.forEach(({ id, connections }, i) => {
+          console.log(chalk.gray(`    ${i + 1}. ${id} (${connections} connections)`));
+        });
+      }
+      if (metadata.lastGenerated || metadata.lastUpdated) {
+        console.log();
+        console.log(chalk.white("  Metadata"));
+        if (metadata.version) {
+          console.log(chalk.gray(`    Version:       ${metadata.version}`));
+        }
+        if (metadata.lastGenerated) {
+          console.log(chalk.gray(`    Generated:     ${metadata.lastGenerated}`));
+        }
+        if (metadata.lastUpdated) {
+          console.log(chalk.gray(`    Last updated:  ${metadata.lastUpdated}`));
+        }
+      }
+      db.close();
+      console.log();
+    } catch (error) {
+      console.error(chalk.red("Failed to get stats:"), String(error));
+      process.exit(1);
+    }
+  });
+  return command;
+}
+export {
+  createStatsCommand
+};
+//# sourceMappingURL=stats.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sources":["../../../src/cli/commands/stats.ts"],"sourcesContent":["/**\n * Stats Command\n *\n * Display knowledge graph statistics.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport { existsSync } from 'fs';\nimport { join } from 'path';\nimport { createDatabase } from '../../core/database.js';\nimport { validateProjectRoot } from '../../core/security.js';\n\n/**\n * Create stats command\n */\nexport function createStatsCommand(): Command {\n  const command = new Command('stats');\n\n  command\n    .description('Display knowledge graph statistics')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('--json', 'Output as JSON')\n    .action(async (options) => {\n      try {\n        // Validate path to prevent traversal attacks\n        const projectRoot = validateProjectRoot(options.path);\n        const dbPath = join(projectRoot, '.kg', 'knowledge.db');\n\n        // Check if database exists\n        if (!existsSync(dbPath)) {\n          console.log(chalk.yellow('  Knowledge graph not found'));\n          console.log(chalk.gray('  Run ') + chalk.cyan('kg graph') + chalk.gray(' to generate one'));\n          return;\n        }\n\n        const db = createDatabase(dbPath);\n        const stats = db.getStats();\n        const metadata = {\n          version: db.getMetadata('version'),\n          lastGenerated: db.getMetadata('lastGenerated'),\n          lastUpdated: db.getMetadata('lastUpdated'),\n        };\n\n        if (options.json) {\n          console.log(JSON.stringify({ stats, metadata }, null, 2));\n          db.close();\n          return;\n        }\n\n        console.log(chalk.cyan('\\n  Knowledge Graph Statistics\\n'));\n\n        // Overview\n        console.log(chalk.white('  Overview'));\n        console.log(chalk.gray(`    Total nodes:  ${stats.totalNodes}`));\n        console.log(chalk.gray(`    Total edges:  ${stats.totalEdges}`));\n        console.log(chalk.gray(`    Orphan nodes: ${stats.orphanNodes}`));\n        console.log(chalk.gray(`    Avg links:    ${stats.avgLinksPerNode}/node`));\n\n        // Nodes by type\n        console.log();\n        console.log(chalk.white('  Nodes by Type'));\n        Object.entries(stats.nodesByType).forEach(([type, count]) => {\n          if (count > 0) {\n            const bar = '█'.repeat(Math.min(count, 20));\n            console.log(chalk.gray(`    ${type.padEnd(12)} ${String(count).padStart(4)} ${chalk.blue(bar)}`));\n          }\n        });\n\n        // Nodes by status\n        console.log();\n        console.log(chalk.white('  Nodes by Status'));\n        Object.entries(stats.nodesByStatus).forEach(([status, count]) => {\n          if (count > 0) {\n            const color = status === 'active' ? chalk.green :\n                         status === 'draft' ? chalk.yellow :\n                         status === 'deprecated' ? chalk.red : chalk.gray;\n            console.log(color(`    ${status.padEnd(12)} ${count}`));\n          }\n        });\n\n        // Most connected\n        if (stats.mostConnected.length > 0) {\n          console.log();\n          console.log(chalk.white('  Most Connected Nodes'));\n          stats.mostConnected.forEach(({ id, connections }, i) => {\n            console.log(chalk.gray(`    ${i + 1}. ${id} (${connections} connections)`));\n          });\n        }\n\n        // Metadata\n        if (metadata.lastGenerated || metadata.lastUpdated) {\n          console.log();\n          console.log(chalk.white('  Metadata'));\n          if (metadata.version) {\n            console.log(chalk.gray(`    Version:       ${metadata.version}`));\n          }\n          if (metadata.lastGenerated) {\n            console.log(chalk.gray(`    Generated:     ${metadata.lastGenerated}`));\n          }\n          if (metadata.lastUpdated) {\n            console.log(chalk.gray(`    Last updated:  ${metadata.lastUpdated}`));\n          }\n        }\n\n        db.close();\n        console.log();\n\n      } catch (error) {\n        console.error(chalk.red('Failed to get stats:'), String(error));\n        process.exit(1);\n      }\n    });\n\n  return command;\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,11 @@
+/**
+ * Sync Command
+ *
+ * Synchronize knowledge graph with claude-flow memory.
+ */
+import { Command } from 'commander';
+/**
+ * Create sync command
+ */
+export declare function createSyncCommand(): Command;
+//# sourceMappingURL=sync.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sync.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AASpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CA4F3C"}

package/dist/cli/commands/sync.js

@@ -0,0 +1,76 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { existsSync } from "fs";
+import { join } from "path";
+import { createDatabase } from "../../core/database.js";
+import { createClaudeFlowIntegration, generateMcpConfig } from "../../integrations/claude-flow.js";
+import { validateProjectRoot } from "../../core/security.js";
+function createSyncCommand() {
+  const command = new Command("sync");
+  command.description("Sync knowledge graph with claude-flow memory").option("-p, --path <path>", "Project root path", ".").option("-n, --namespace <namespace>", "Memory namespace", "knowledge-graph").option("--show-commands", "Show MCP commands instead of executing").option("--hooks", "Show hook configuration commands").action(async (options) => {
+    const spinner = ora("Syncing with claude-flow...").start();
+    try {
+      const projectRoot = validateProjectRoot(options.path);
+      const dbPath = join(projectRoot, ".kg", "knowledge.db");
+      if (!existsSync(dbPath)) {
+        spinner.fail("Knowledge graph not found");
+        console.log(chalk.gray("  Run ") + chalk.cyan("kg graph") + chalk.gray(" first"));
+        process.exit(1);
+      }
+      const db = createDatabase(dbPath);
+      const integration = createClaudeFlowIntegration({
+        namespace: options.namespace,
+        syncOnChange: true
+      });
+      if (options.showCommands) {
+        spinner.stop();
+        console.log(chalk.cyan("\n  Claude-Flow MCP Commands\n"));
+        console.log(chalk.gray("  Use these commands in Claude Code:\n"));
+        integration.generateRetrievalCommands().forEach((cmd) => {
+          console.log(chalk.white(`  ${cmd}`));
+        });
+        db.close();
+        return;
+      }
+      if (options.hooks) {
+        spinner.stop();
+        console.log(chalk.cyan("\n  Claude-Flow Hook Commands\n"));
+        console.log(chalk.gray("  Add these to your workflow:\n"));
+        integration.generateHookCommands().forEach((cmd) => {
+          console.log(chalk.white(`  ${cmd}`));
+        });
+        db.close();
+        return;
+      }
+      spinner.text = "Preparing sync data...";
+      const result = await integration.syncToMemory(db);
+      spinner.succeed("Sync complete!");
+      console.log();
+      console.log(chalk.white("  Results:"));
+      console.log(chalk.green(`    Synced: ${result.synced} entries`));
+      if (result.failed > 0) {
+        console.log(chalk.yellow(`    Failed: ${result.failed}`));
+      }
+      console.log();
+      console.log(chalk.cyan("  Memory Retrieval:"));
+      console.log(chalk.gray(`    Get stats: mcp__claude-flow__memory_usage { action: "retrieve", key: "stats", namespace: "${options.namespace}" }`));
+      console.log(chalk.gray(`    Get node:  mcp__claude-flow__memory_usage { action: "retrieve", key: "node/<id>", namespace: "${options.namespace}" }`));
+      db.close();
+      console.log();
+    } catch (error) {
+      spinner.fail("Sync failed");
+      console.error(chalk.red(String(error)));
+      process.exit(1);
+    }
+  });
+  command.command("config").description("Show MCP configuration for CLAUDE.md").option("-n, --namespace <namespace>", "Memory namespace", "knowledge-graph").action((options) => {
+    const config = generateMcpConfig(options.namespace);
+    console.log(config);
+  });
+  return command;
+}
+export {
+  createSyncCommand
+};
+//# sourceMappingURL=sync.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sync.js","sources":["../../../src/cli/commands/sync.ts"],"sourcesContent":["/**\n * Sync Command\n *\n * Synchronize knowledge graph with claude-flow memory.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport { existsSync } from 'fs';\nimport { join } from 'path';\nimport { createDatabase } from '../../core/database.js';\nimport { createClaudeFlowIntegration, generateMcpConfig } from '../../integrations/claude-flow.js';\nimport { validateProjectRoot } from '../../core/security.js';\n\n/**\n * Create sync command\n */\nexport function createSyncCommand(): Command {\n  const command = new Command('sync');\n\n  command\n    .description('Sync knowledge graph with claude-flow memory')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-n, --namespace <namespace>', 'Memory namespace', 'knowledge-graph')\n    .option('--show-commands', 'Show MCP commands instead of executing')\n    .option('--hooks', 'Show hook configuration commands')\n    .action(async (options) => {\n      const spinner = ora('Syncing with claude-flow...').start();\n\n      try {\n        // Validate path to prevent traversal attacks\n        const projectRoot = validateProjectRoot(options.path);\n        const dbPath = join(projectRoot, '.kg', 'knowledge.db');\n\n        // Check if database exists\n        if (!existsSync(dbPath)) {\n          spinner.fail('Knowledge graph not found');\n          console.log(chalk.gray('  Run ') + chalk.cyan('kg graph') + chalk.gray(' first'));\n          process.exit(1);\n        }\n\n        const db = createDatabase(dbPath);\n        const integration = createClaudeFlowIntegration({\n          namespace: options.namespace,\n          syncOnChange: true,\n        });\n\n        if (options.showCommands) {\n          spinner.stop();\n          console.log(chalk.cyan('\\n  Claude-Flow MCP Commands\\n'));\n          console.log(chalk.gray('  Use these commands in Claude Code:\\n'));\n          integration.generateRetrievalCommands().forEach(cmd => {\n            console.log(chalk.white(`  ${cmd}`));\n          });\n          db.close();\n          return;\n        }\n\n        if (options.hooks) {\n          spinner.stop();\n          console.log(chalk.cyan('\\n  Claude-Flow Hook Commands\\n'));\n          console.log(chalk.gray('  Add these to your workflow:\\n'));\n          integration.generateHookCommands().forEach(cmd => {\n            console.log(chalk.white(`  ${cmd}`));\n          });\n          db.close();\n          return;\n        }\n\n        // Perform sync\n        spinner.text = 'Preparing sync data...';\n        const result = await integration.syncToMemory(db);\n\n        spinner.succeed('Sync complete!');\n\n        console.log();\n        console.log(chalk.white('  Results:'));\n        console.log(chalk.green(`    Synced: ${result.synced} entries`));\n        if (result.failed > 0) {\n          console.log(chalk.yellow(`    Failed: ${result.failed}`));\n        }\n\n        // Show helpful commands\n        console.log();\n        console.log(chalk.cyan('  Memory Retrieval:'));\n        console.log(chalk.gray(`    Get stats: mcp__claude-flow__memory_usage { action: \"retrieve\", key: \"stats\", namespace: \"${options.namespace}\" }`));\n        console.log(chalk.gray(`    Get node:  mcp__claude-flow__memory_usage { action: \"retrieve\", key: \"node/<id>\", namespace: \"${options.namespace}\" }`));\n\n        db.close();\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Sync failed');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  // Config subcommand\n  command\n    .command('config')\n    .description('Show MCP configuration for CLAUDE.md')\n    .option('-n, --namespace <namespace>', 'Memory namespace', 'knowledge-graph')\n    .action((options) => {\n      const config = generateMcpConfig(options.namespace);\n      console.log(config);\n    });\n\n  return command;\n}\n"],"names":[],"mappings":";;;;;;;;AAkBO,SAAS,oBAA6B;AAC3C,QAAM,UAAU,IAAI,QAAQ,MAAM;AAElC,UACG,YAAY,8CAA8C,EAC1D,OAAO,qBAAqB,qBAAqB,GAAG,EACpD,OAAO,+BAA+B,oBAAoB,iBAAiB,EAC3E,OAAO,mBAAmB,wCAAwC,EAClE,OAAO,WAAW,kCAAkC,EACpD,OAAO,OAAO,YAAY;AACzB,UAAM,UAAU,IAAI,6BAA6B,EAAE,MAAA;AAEnD,QAAI;AAEF,YAAM,cAAc,oBAAoB,QAAQ,IAAI;AACpD,YAAM,SAAS,KAAK,aAAa,OAAO,cAAc;AAGtD,UAAI,CAAC,WAAW,MAAM,GAAG;AACvB,gBAAQ,KAAK,2BAA2B;AACxC,gBAAQ,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,QAAQ,CAAC;AAChF,gBAAQ,KAAK,CAAC;AAAA,MAChB;AAEA,YAAM,KAAK,eAAe,MAAM;AAChC,YAAM,cAAc,4BAA4B;AAAA,QAC9C,WAAW,QAAQ;AAAA,QACnB,cAAc;AAAA,MAAA,CACf;AAED,UAAI,QAAQ,cAAc;AACxB,gBAAQ,KAAA;AACR,gBAAQ,IAAI,MAAM,KAAK,gCAAgC,CAAC;AACxD,gBAAQ,IAAI,MAAM,KAAK,wCAAwC,CAAC;AAChE,oBAAY,0BAAA,EAA4B,QAAQ,CAAA,QAAO;AACrD,kBAAQ,IAAI,MAAM,MAAM,KAAK,GAAG,EAAE,CAAC;AAAA,QACrC,CAAC;AACD,WAAG,MAAA;AACH;AAAA,MACF;AAEA,UAAI,QAAQ,OAAO;AACjB,gBAAQ,KAAA;AACR,gBAAQ,IAAI,MAAM,KAAK,iCAAiC,CAAC;AACzD,gBAAQ,IAAI,MAAM,KAAK,iCAAiC,CAAC;AACzD,oBAAY,qBAAA,EAAuB,QAAQ,CAAA,QAAO;AAChD,kBAAQ,IAAI,MAAM,MAAM,KAAK,GAAG,EAAE,CAAC;AAAA,QACrC,CAAC;AACD,WAAG,MAAA;AACH;AAAA,MACF;AAGA,cAAQ,OAAO;AACf,YAAM,SAAS,MAAM,YAAY,aAAa,EAAE;AAEhD,cAAQ,QAAQ,gBAAgB;AAEhC,cAAQ,IAAA;AACR,cAAQ,IAAI,MAAM,MAAM,YAAY,CAAC;AACrC,cAAQ,IAAI,MAAM,MAAM,eAAe,OAAO,MAAM,UAAU,CAAC;AAC/D,UAAI,OAAO,SAAS,GAAG;AACrB,gBAAQ,IAAI,MAAM,OAAO,eAAe,OAAO,MAAM,EAAE,CAAC;AAAA,MAC1D;AAGA,cAAQ,IAAA;AACR,cAAQ,IAAI,MAAM,KAAK,qBAAqB,CAAC;AAC7C,cAAQ,IAAI,MAAM,KAAK,iGAAiG,QAAQ,SAAS,KAAK,CAAC;AAC/I,cAAQ,IAAI,MAAM,KAAK,qGAAqG,QAAQ,SAAS,KAAK,CAAC;AAEnJ,SAAG,MAAA;AACH,cAAQ,IAAA;AAAA,IAEV,SAAS,OAAO;AACd,cAAQ,KAAK,aAAa;AAC1B,cAAQ,MAAM,MAAM,IAAI,OAAO,KAAK,CAAC,CAAC;AACtC,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,CAAC;AAGH,UACG,QAAQ,QAAQ,EAChB,YAAY,sCAAsC,EAClD,OAAO,+BAA+B,oBAAoB,iBAAiB,EAC3E,OAAO,CAAC,YAAY;AACnB,UAAM,SAAS,kBAAkB,QAAQ,SAAS;AAClD,YAAQ,IAAI,MAAM;AAAA,EACpB,CAAC;AAEH,SAAO;AACT;"}

package/dist/cli/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Knowledge Graph Agent CLI
+ *
+ * Main CLI setup and command registration.
+ */
+import { Command } from 'commander';
+/**
+ * Create and configure the CLI program
+ */
+export declare function createCLI(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAepC;;GAEG;AACH,wBAAgB,SAAS,IAAI,OAAO,CA4CnC"}