@weavelogic/knowledge-graph-agent 0.1.0

package/README.md

@@ -0,0 +1,264 @@
+# @weavelogic/knowledge-graph-agent
+
+A powerful NPM library for creating and managing knowledge graphs for Claude Code. Integrates with Obsidian-style documentation and claude-flow for AI coordination.
+
+[![npm version](https://img.shields.io/npm/v/@weavelogic/knowledge-graph-agent.svg)](https://www.npmjs.com/package/@weavelogic/knowledge-graph-agent)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- **Knowledge Graph Generation** - Automatically generate knowledge graphs from markdown documentation
+- **Docs Initialization** - Create structured documentation directories following weave-nn methodology
+- **CLAUDE.md Management** - Generate and update CLAUDE.md configuration files
+- **Claude-Flow Integration** - Sync knowledge graphs with claude-flow memory for cross-session persistence
+- **Full-Text Search** - SQLite-backed search across all documentation
+
+## Installation
+
+```bash
+npm install @weavelogic/knowledge-graph-agent
+```
+
+Or use directly with npx:
+
+```bash
+npx @weavelogic/knowledge-graph-agent init
+```
+
+## Quick Start
+
+### 1. Initialize Knowledge Graph
+
+```bash
+# Initialize in current project
+kg init
+
+# Initialize with custom paths
+kg init --path /path/to/project --docs documentation
+```
+
+### 2. Initialize Documentation Directory
+
+```bash
+# Create docs with weave-nn structure
+kg docs init
+
+# Create minimal docs
+kg docs init --no-examples
+```
+
+### 3. Generate Knowledge Graph
+
+```bash
+# Full generation
+kg graph
+
+# Incremental update
+kg graph --update
+```
+
+### 4. Update CLAUDE.md
+
+```bash
+# Generate CLAUDE.md with knowledge graph integration
+kg claude update
+
+# Use full template with all sections
+kg claude update --template full
+```
+
+### 5. Sync with Claude-Flow
+
+```bash
+# Sync to claude-flow memory
+kg sync
+
+# Show MCP commands for manual sync
+kg sync --show-commands
+```
+
+## CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `kg init` | Initialize knowledge graph in project |
+| `kg graph` | Generate/update knowledge graph |
+| `kg docs init` | Initialize docs directory |
+| `kg docs status` | Show documentation status |
+| `kg claude update` | Update CLAUDE.md |
+| `kg claude preview` | Preview CLAUDE.md content |
+| `kg sync` | Sync with claude-flow memory |
+| `kg stats` | Display graph statistics |
+| `kg search <query>` | Search the knowledge graph |
+
+## Programmatic Usage
+
+```typescript
+import {
+  createKnowledgeGraph,
+  createDatabase,
+  initDocs,
+  generateClaudeMd,
+  quickInit,
+} from '@weavelogic/knowledge-graph-agent';
+
+// Quick initialization
+const result = await quickInit({
+  projectRoot: '/path/to/project',
+  docsPath: 'docs',
+  generateGraph: true,
+  updateClaudeMd: true,
+});
+
+// Or use individual components
+const db = createDatabase('.kg/knowledge.db');
+const graph = createKnowledgeGraph('my-project', '/project/root');
+
+// Generate docs
+await initDocs({
+  projectRoot: '/project/root',
+  docsPath: 'docs',
+  includeExamples: true,
+});
+
+// Generate CLAUDE.md
+const claudeContent = generateClaudeMd({
+  projectRoot: '/project/root',
+  includeKnowledgeGraph: true,
+  includeClaudeFlow: true,
+});
+```
+
+## Documentation Structure
+
+The generated docs directory follows the weave-nn methodology:
+
+```
+docs/
+├── README.md           # Documentation home
+├── PRIMITIVES.md       # Technology primitives
+├── MOC.md              # Map of Content
+├── concepts/           # Abstract concepts
+│   ├── architecture/
+│   └── patterns/
+├── components/         # Reusable components
+│   ├── ui/
+│   └── utilities/
+├── services/           # Backend services
+│   ├── api/
+│   └── workers/
+├── features/           # Product features
+│   ├── core/
+│   └── advanced/
+├── integrations/       # External integrations
+│   ├── databases/
+│   ├── auth-providers/
+│   └── storage/
+├── standards/          # Coding standards
+│   ├── coding-standards/
+│   └── build-tools/
+├── guides/             # How-to guides
+│   ├── getting-started/
+│   └── testing/
+└── references/         # API references
+    ├── api/
+    └── cli/
+```
+
+## Knowledge Graph Schema
+
+### Node Types
+
+| Type | Description |
+|------|-------------|
+| `concept` | Abstract concepts and ideas |
+| `technical` | Technical components and implementations |
+| `feature` | Product features and capabilities |
+| `primitive` | Base technology primitives |
+| `service` | Backend services and APIs |
+| `guide` | How-to guides and tutorials |
+| `standard` | Coding standards and conventions |
+| `integration` | External integrations |
+
+### Node Frontmatter
+
+```yaml
+---
+title: My Document
+type: concept
+status: active
+tags: [concept, architecture]
+created: 2025-01-01
+updated: 2025-01-01
+aliases: [Alternative Name]
+related: [other-document]
+---
+```
+
+## Claude-Flow Integration
+
+The knowledge graph integrates with claude-flow for:
+
+- **Memory Persistence**: Store graph data in claude-flow memory
+- **Cross-Session Context**: Access knowledge across Claude sessions
+- **Agent Coordination**: Share knowledge between swarm agents
+
+### MCP Commands
+
+```javascript
+// Store node in memory
+mcp__claude-flow__memory_usage {
+  action: "store",
+  key: "node/<id>",
+  namespace: "knowledge-graph",
+  value: { ... }
+}
+
+// Retrieve node
+mcp__claude-flow__memory_usage {
+  action: "retrieve",
+  key: "node/<id>",
+  namespace: "knowledge-graph"
+}
+
+// Search nodes
+mcp__claude-flow__memory_search {
+  pattern: "node/*",
+  namespace: "knowledge-graph"
+}
+```
+
+## Configuration
+
+Create `.kg/config.json` to customize behavior:
+
+```json
+{
+  "projectRoot": ".",
+  "docsRoot": "docs",
+  "graph": {
+    "includePatterns": ["**/*.md"],
+    "excludePatterns": ["node_modules/**", "dist/**"]
+  },
+  "database": {
+    "path": ".kg/knowledge.db"
+  },
+  "claudeFlow": {
+    "enabled": true,
+    "namespace": "knowledge-graph",
+    "syncOnChange": true
+  }
+}
+```
+
+## API Reference
+
+See [docs/API.md](./docs/API.md) for detailed API documentation.
+
+## Contributing
+
+Contributions are welcome! Please read our [Contributing Guide](./docs/CONTRIBUTING.md).
+
+## License
+
+MIT

package/dist/cli/bin.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * Knowledge Graph Agent CLI
+ *
+ * Command-line interface for knowledge graph operations.
+ */
+export {};
+//# sourceMappingURL=bin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../../src/cli/bin.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/cli/bin.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+import chalk from "chalk";
+import { createCLI } from "./index.js";
+async function main() {
+  const program = createCLI();
+  try {
+    await program.parseAsync(process.argv);
+  } catch (error) {
+    if (error instanceof Error) {
+      console.error(chalk.red("Error:"), error.message);
+      process.exit(1);
+    }
+    throw error;
+  }
+}
+main().catch((error) => {
+  console.error(chalk.red("Fatal error:"), error);
+  process.exit(1);
+});
+//# sourceMappingURL=bin.js.map

package/dist/cli/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sources":["../../src/cli/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * Knowledge Graph Agent CLI\n *\n * Command-line interface for knowledge graph operations.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport { createCLI } from './index.js';\n\nasync function main(): Promise<void> {\n  const program = createCLI();\n\n  try {\n    await program.parseAsync(process.argv);\n  } catch (error) {\n    if (error instanceof Error) {\n      console.error(chalk.red('Error:'), error.message);\n      process.exit(1);\n    }\n    throw error;\n  }\n}\n\nmain().catch((error) => {\n  console.error(chalk.red('Fatal error:'), error);\n  process.exit(1);\n});\n"],"names":[],"mappings":";;;AAWA,eAAe,OAAsB;AACnC,QAAM,UAAU,UAAA;AAEhB,MAAI;AACF,UAAM,QAAQ,WAAW,QAAQ,IAAI;AAAA,EACvC,SAAS,OAAO;AACd,QAAI,iBAAiB,OAAO;AAC1B,cAAQ,MAAM,MAAM,IAAI,QAAQ,GAAG,MAAM,OAAO;AAChD,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,UAAM;AAAA,EACR;AACF;AAEA,OAAO,MAAM,CAAC,UAAU;AACtB,UAAQ,MAAM,MAAM,IAAI,cAAc,GAAG,KAAK;AAC9C,UAAQ,KAAK,CAAC;AAChB,CAAC;"}

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

@@ -0,0 +1,11 @@
+/**
+ * Claude Command
+ *
+ * Manage CLAUDE.md configuration file.
+ */
+import { Command } from 'commander';
+/**
+ * Create claude command
+ */
+export declare function createClaudeCommand(): Command;
+//# sourceMappingURL=claude.d.ts.map

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

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

package/dist/cli/commands/claude.js

@@ -0,0 +1,102 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { existsSync } from "fs";
+import { join } from "path";
+import { updateClaudeMd, generateClaudeMd, getSectionTemplate, listSectionTemplates, addSection } from "../../generators/claude-md.js";
+import { validateProjectRoot, validatePath } from "../../core/security.js";
+function createClaudeCommand() {
+  const command = new Command("claude");
+  command.description("CLAUDE.md management commands");
+  command.command("update").description("Generate or update CLAUDE.md file").option("-p, --path <path>", "Project root path", ".").option("-o, --output <path>", "Output path for CLAUDE.md").option("-t, --template <template>", "Template to use (default, minimal, full)").option("--no-kg", "Skip knowledge graph section").option("--no-cf", "Skip claude-flow section").option("-f, --force", "Overwrite existing file").action(async (options) => {
+    const spinner = ora("Updating CLAUDE.md...").start();
+    try {
+      const projectRoot = validateProjectRoot(options.path);
+      const claudeMdPath = options.output ? validatePath(projectRoot, options.output) : join(projectRoot, "CLAUDE.md");
+      if (existsSync(claudeMdPath) && !options.force) {
+        spinner.warn("CLAUDE.md already exists. Use --force to overwrite.");
+        return;
+      }
+      const result = await updateClaudeMd({
+        projectRoot,
+        outputPath: claudeMdPath,
+        template: options.template,
+        includeKnowledgeGraph: options.kg !== false,
+        includeClaudeFlow: options.cf !== false
+      });
+      if (result.created) {
+        spinner.succeed("CLAUDE.md created!");
+      } else {
+        spinner.succeed("CLAUDE.md updated!");
+      }
+      console.log();
+      console.log(chalk.gray("  Path:"), chalk.white(result.path));
+      console.log(chalk.gray("  Size:"), chalk.white(`${result.content.length} bytes`));
+      console.log();
+    } catch (error) {
+      spinner.fail("Failed to update CLAUDE.md");
+      console.error(chalk.red(String(error)));
+      process.exit(1);
+    }
+  });
+  command.command("preview").description("Preview CLAUDE.md without writing").option("-p, --path <path>", "Project root path", ".").option("-t, --template <template>", "Template to use").action(async (options) => {
+    try {
+      const projectRoot = validateProjectRoot(options.path);
+      const content = generateClaudeMd({
+        projectRoot,
+        template: options.template,
+        includeKnowledgeGraph: true,
+        includeClaudeFlow: true
+      });
+      console.log(chalk.cyan("\n--- CLAUDE.md Preview ---\n"));
+      console.log(content);
+      console.log(chalk.cyan("\n--- End Preview ---\n"));
+    } catch (error) {
+      console.error(chalk.red("Failed to generate preview:"), String(error));
+      process.exit(1);
+    }
+  });
+  command.command("add-section <name>").description("Add a section to existing CLAUDE.md").option("-p, --path <path>", "Project root path", ".").action(async (name, options) => {
+    try {
+      const projectRoot = validateProjectRoot(options.path);
+      const template = getSectionTemplate(name);
+      if (!template) {
+        console.log(chalk.yellow(`Unknown section template: ${name}`));
+        console.log();
+        console.log(chalk.white("Available templates:"));
+        listSectionTemplates().forEach((t) => {
+          console.log(chalk.gray(`  - ${t}`));
+        });
+        return;
+      }
+      const added = addSection(projectRoot, template);
+      if (added) {
+        console.log(chalk.green(`✓ Added section: ${template.title}`));
+      } else {
+        console.log(chalk.yellow(`Section "${template.title}" already exists or CLAUDE.md not found`));
+      }
+    } catch (error) {
+      console.error(chalk.red("Failed to add section:"), String(error));
+      process.exit(1);
+    }
+  });
+  command.command("templates").description("List available section templates").action(() => {
+    console.log(chalk.white("\n  Available Section Templates\n"));
+    const templates = listSectionTemplates();
+    templates.forEach((name) => {
+      const template = getSectionTemplate(name);
+      if (template) {
+        console.log(chalk.cyan(`  ${name}`));
+        console.log(chalk.gray(`    ${template.title}`));
+      }
+    });
+    console.log();
+    console.log(chalk.gray("  Add with: ") + chalk.white("kg claude add-section <name>"));
+    console.log();
+  });
+  return command;
+}
+export {
+  createClaudeCommand
+};
+//# sourceMappingURL=claude.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sources":["../../../src/cli/commands/claude.ts"],"sourcesContent":["/**\n * Claude Command\n *\n * Manage CLAUDE.md configuration file.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport { existsSync, readFileSync } from 'fs';\nimport { join } from 'path';\nimport {\n  generateClaudeMd,\n  updateClaudeMd,\n  addSection,\n  getSectionTemplate,\n  listSectionTemplates,\n} from '../../generators/claude-md.js';\nimport { validateProjectRoot, validatePath } from '../../core/security.js';\n\n/**\n * Create claude command\n */\nexport function createClaudeCommand(): Command {\n  const command = new Command('claude');\n\n  command\n    .description('CLAUDE.md management commands');\n\n  // Update/generate subcommand\n  command\n    .command('update')\n    .description('Generate or update CLAUDE.md file')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-o, --output <path>', 'Output path for CLAUDE.md')\n    .option('-t, --template <template>', 'Template to use (default, minimal, full)')\n    .option('--no-kg', 'Skip knowledge graph section')\n    .option('--no-cf', 'Skip claude-flow section')\n    .option('-f, --force', 'Overwrite existing file')\n    .action(async (options) => {\n      const spinner = ora('Updating CLAUDE.md...').start();\n\n      try {\n        // Validate paths to prevent traversal attacks\n        const projectRoot = validateProjectRoot(options.path);\n        const claudeMdPath = options.output\n          ? validatePath(projectRoot, options.output)\n          : join(projectRoot, 'CLAUDE.md');\n\n        // Check if file exists\n        if (existsSync(claudeMdPath) && !options.force) {\n          spinner.warn('CLAUDE.md already exists. Use --force to overwrite.');\n          return;\n        }\n\n        const result = await updateClaudeMd({\n          projectRoot,\n          outputPath: claudeMdPath,\n          template: options.template,\n          includeKnowledgeGraph: options.kg !== false,\n          includeClaudeFlow: options.cf !== false,\n        });\n\n        if (result.created) {\n          spinner.succeed('CLAUDE.md created!');\n        } else {\n          spinner.succeed('CLAUDE.md updated!');\n        }\n\n        console.log();\n        console.log(chalk.gray('  Path:'), chalk.white(result.path));\n        console.log(chalk.gray('  Size:'), chalk.white(`${result.content.length} bytes`));\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Failed to update CLAUDE.md');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  // Preview subcommand\n  command\n    .command('preview')\n    .description('Preview CLAUDE.md without writing')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-t, --template <template>', 'Template to use')\n    .action(async (options) => {\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n\n        const content = generateClaudeMd({\n          projectRoot,\n          template: options.template,\n          includeKnowledgeGraph: true,\n          includeClaudeFlow: true,\n        });\n\n        console.log(chalk.cyan('\\n--- CLAUDE.md Preview ---\\n'));\n        console.log(content);\n        console.log(chalk.cyan('\\n--- End Preview ---\\n'));\n\n      } catch (error) {\n        console.error(chalk.red('Failed to generate preview:'), String(error));\n        process.exit(1);\n      }\n    });\n\n  // Add section subcommand\n  command\n    .command('add-section <name>')\n    .description('Add a section to existing CLAUDE.md')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .action(async (name, options) => {\n      try {\n        const projectRoot = validateProjectRoot(options.path);\n\n        // Check for built-in section template\n        const template = getSectionTemplate(name);\n\n        if (!template) {\n          console.log(chalk.yellow(`Unknown section template: ${name}`));\n          console.log();\n          console.log(chalk.white('Available templates:'));\n          listSectionTemplates().forEach(t => {\n            console.log(chalk.gray(`  - ${t}`));\n          });\n          return;\n        }\n\n        const added = addSection(projectRoot, template);\n\n        if (added) {\n          console.log(chalk.green(`✓ Added section: ${template.title}`));\n        } else {\n          console.log(chalk.yellow(`Section \"${template.title}\" already exists or CLAUDE.md not found`));\n        }\n\n      } catch (error) {\n        console.error(chalk.red('Failed to add section:'), String(error));\n        process.exit(1);\n      }\n    });\n\n  // List templates subcommand\n  command\n    .command('templates')\n    .description('List available section templates')\n    .action(() => {\n      console.log(chalk.white('\\n  Available Section Templates\\n'));\n\n      const templates = listSectionTemplates();\n      templates.forEach(name => {\n        const template = getSectionTemplate(name);\n        if (template) {\n          console.log(chalk.cyan(`  ${name}`));\n          console.log(chalk.gray(`    ${template.title}`));\n        }\n      });\n\n      console.log();\n      console.log(chalk.gray('  Add with: ') + chalk.white('kg claude add-section <name>'));\n      console.log();\n    });\n\n  return command;\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,11 @@
+/**
+ * Docs Command
+ *
+ * Initialize and manage documentation directory.
+ */
+import { Command } from 'commander';
+/**
+ * Create docs command
+ */
+export declare function createDocsCommand(): Command;
+//# sourceMappingURL=docs.d.ts.map

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

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

package/dist/cli/commands/docs.js

@@ -0,0 +1,108 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+import { docsExist, initDocs, getDocsPath } from "../../generators/docs-init.js";
+import { validateProjectRoot, validateDocsPath } from "../../core/security.js";
+function createDocsCommand() {
+  const command = new Command("docs");
+  command.description("Documentation management commands");
+  command.command("init").description("Initialize documentation directory with weave-nn structure").option("-p, --path <path>", "Project root path", ".").option("-d, --docs <path>", "Docs directory path", "docs").option("-t, --template <template>", "Template to use (default, minimal)").option("--no-examples", "Skip example files").option("--no-detect", "Skip framework detection").option("-f, --force", "Overwrite existing files").action(async (options) => {
+    const spinner = ora("Initializing documentation...").start();
+    try {
+      const projectRoot = validateProjectRoot(options.path);
+      const docsPath = options.docs;
+      validateDocsPath(projectRoot, docsPath);
+      if (docsExist(projectRoot, docsPath) && !options.force) {
+        spinner.warn(`Documentation already exists at ${docsPath}`);
+        console.log(chalk.gray("  Use --force to reinitialize"));
+        return;
+      }
+      const result = await initDocs({
+        projectRoot,
+        docsPath,
+        includeExamples: options.examples !== false,
+        detectFramework: options.detect !== false
+      });
+      if (result.success) {
+        spinner.succeed("Documentation initialized!");
+      } else {
+        spinner.warn("Documentation initialized with errors");
+      }
+      console.log();
+      console.log(chalk.white("  Created:"));
+      console.log(chalk.gray(`    Path: ${result.docsPath}`));
+      console.log(chalk.green(`    Files: ${result.filesCreated.length}`));
+      if (result.errors.length > 0) {
+        console.log();
+        console.log(chalk.yellow("  Errors:"));
+        result.errors.forEach((err) => {
+          console.log(chalk.gray(`    - ${err}`));
+        });
+      }
+      console.log();
+      console.log(chalk.cyan("Structure created:"));
+      console.log(chalk.gray(`
+    ${docsPath}/
+    ├── README.md           # Documentation home
+    ├── PRIMITIVES.md       # Technology primitives
+    ├── MOC.md              # Map of Content
+    ├── concepts/           # Abstract concepts
+    ├── components/         # Reusable components
+    ├── services/           # Backend services
+    ├── features/           # Product features
+    ├── integrations/       # External integrations
+    ├── standards/          # Coding standards
+    ├── guides/             # How-to guides
+    └── references/         # API references
+        `));
+      console.log(chalk.cyan("Next: ") + chalk.white("kg graph") + chalk.gray(" to generate knowledge graph"));
+      console.log();
+    } catch (error) {
+      spinner.fail("Failed to initialize documentation");
+      console.error(chalk.red(String(error)));
+      process.exit(1);
+    }
+  });
+  command.command("status").description("Show documentation status").option("-p, --path <path>", "Project root path", ".").action(async (options) => {
+    const projectRoot = validateProjectRoot(options.path);
+    const docsPath = getDocsPath(projectRoot);
+    if (!docsPath) {
+      console.log(chalk.yellow("  No documentation directory found"));
+      console.log(chalk.gray("  Run ") + chalk.cyan("kg docs init") + chalk.gray(" to create one"));
+      return;
+    }
+    console.log(chalk.white("\n  Documentation Status\n"));
+    console.log(chalk.gray("  Path:"), chalk.white(docsPath));
+    console.log();
+    const fg = await import("fast-glob");
+    const files = await fg.default("**/*.md", {
+      cwd: docsPath,
+      ignore: ["node_modules/**", ".git/**"]
+    });
+    console.log(chalk.gray("  Markdown files:"), chalk.white(files.length));
+    const keyFiles = ["README.md", "PRIMITIVES.md", "MOC.md"];
+    const fs = await import("fs");
+    const path = await import("path");
+    console.log();
+    console.log(chalk.white("  Key Files:"));
+    keyFiles.forEach((file) => {
+      const exists = fs.existsSync(path.join(docsPath, file));
+      const icon = exists ? chalk.green("✓") : chalk.red("✗");
+      console.log(`    ${icon} ${file}`);
+    });
+    const dirs = ["concepts", "components", "services", "features", "guides"];
+    console.log();
+    console.log(chalk.white("  Directories:"));
+    dirs.forEach((dir) => {
+      const exists = fs.existsSync(path.join(docsPath, dir));
+      const icon = exists ? chalk.green("✓") : chalk.gray("○");
+      console.log(`    ${icon} ${dir}/`);
+    });
+    console.log();
+  });
+  return command;
+}
+export {
+  createDocsCommand
+};
+//# sourceMappingURL=docs.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sources":["../../../src/cli/commands/docs.ts"],"sourcesContent":["/**\n * Docs Command\n *\n * Initialize and manage documentation directory.\n */\n\nimport { Command } from 'commander';\nimport chalk from 'chalk';\nimport ora from 'ora';\nimport { initDocs, docsExist, getDocsPath } from '../../generators/docs-init.js';\nimport { validateProjectRoot, validateDocsPath } from '../../core/security.js';\n\n/**\n * Create docs command\n */\nexport function createDocsCommand(): Command {\n  const command = new Command('docs');\n\n  command\n    .description('Documentation management commands');\n\n  // Init subcommand\n  command\n    .command('init')\n    .description('Initialize documentation directory with weave-nn structure')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .option('-d, --docs <path>', 'Docs directory path', 'docs')\n    .option('-t, --template <template>', 'Template to use (default, minimal)')\n    .option('--no-examples', 'Skip example files')\n    .option('--no-detect', 'Skip framework detection')\n    .option('-f, --force', 'Overwrite existing files')\n    .action(async (options) => {\n      const spinner = ora('Initializing documentation...').start();\n\n      try {\n        // Validate paths to prevent traversal attacks\n        const projectRoot = validateProjectRoot(options.path);\n        const docsPath = options.docs;\n        validateDocsPath(projectRoot, docsPath); // Ensure docs stays within project\n\n        // Check if docs already exist\n        if (docsExist(projectRoot, docsPath) && !options.force) {\n          spinner.warn(`Documentation already exists at ${docsPath}`);\n          console.log(chalk.gray('  Use --force to reinitialize'));\n          return;\n        }\n\n        const result = await initDocs({\n          projectRoot,\n          docsPath,\n          includeExamples: options.examples !== false,\n          detectFramework: options.detect !== false,\n        });\n\n        if (result.success) {\n          spinner.succeed('Documentation initialized!');\n        } else {\n          spinner.warn('Documentation initialized with errors');\n        }\n\n        console.log();\n        console.log(chalk.white('  Created:'));\n        console.log(chalk.gray(`    Path: ${result.docsPath}`));\n        console.log(chalk.green(`    Files: ${result.filesCreated.length}`));\n\n        if (result.errors.length > 0) {\n          console.log();\n          console.log(chalk.yellow('  Errors:'));\n          result.errors.forEach(err => {\n            console.log(chalk.gray(`    - ${err}`));\n          });\n        }\n\n        console.log();\n        console.log(chalk.cyan('Structure created:'));\n        console.log(chalk.gray(`\n    ${docsPath}/\n    ├── README.md           # Documentation home\n    ├── PRIMITIVES.md       # Technology primitives\n    ├── MOC.md              # Map of Content\n    ├── concepts/           # Abstract concepts\n    ├── components/         # Reusable components\n    ├── services/           # Backend services\n    ├── features/           # Product features\n    ├── integrations/       # External integrations\n    ├── standards/          # Coding standards\n    ├── guides/             # How-to guides\n    └── references/         # API references\n        `));\n\n        console.log(chalk.cyan('Next: ') + chalk.white('kg graph') + chalk.gray(' to generate knowledge graph'));\n        console.log();\n\n      } catch (error) {\n        spinner.fail('Failed to initialize documentation');\n        console.error(chalk.red(String(error)));\n        process.exit(1);\n      }\n    });\n\n  // Status subcommand\n  command\n    .command('status')\n    .description('Show documentation status')\n    .option('-p, --path <path>', 'Project root path', '.')\n    .action(async (options) => {\n      // Validate path to prevent traversal\n      const projectRoot = validateProjectRoot(options.path);\n      const docsPath = getDocsPath(projectRoot);\n\n      if (!docsPath) {\n        console.log(chalk.yellow('  No documentation directory found'));\n        console.log(chalk.gray('  Run ') + chalk.cyan('kg docs init') + chalk.gray(' to create one'));\n        return;\n      }\n\n      console.log(chalk.white('\\n  Documentation Status\\n'));\n      console.log(chalk.gray('  Path:'), chalk.white(docsPath));\n      console.log();\n\n      // Count files\n      const fg = await import('fast-glob');\n      const files = await fg.default('**/*.md', {\n        cwd: docsPath,\n        ignore: ['node_modules/**', '.git/**'],\n      });\n\n      console.log(chalk.gray('  Markdown files:'), chalk.white(files.length));\n\n      // Check for key files\n      const keyFiles = ['README.md', 'PRIMITIVES.md', 'MOC.md'];\n      const fs = await import('fs');\n      const path = await import('path');\n\n      console.log();\n      console.log(chalk.white('  Key Files:'));\n      keyFiles.forEach(file => {\n        const exists = fs.existsSync(path.join(docsPath, file));\n        const icon = exists ? chalk.green('✓') : chalk.red('✗');\n        console.log(`    ${icon} ${file}`);\n      });\n\n      // Check directories\n      const dirs = ['concepts', 'components', 'services', 'features', 'guides'];\n      console.log();\n      console.log(chalk.white('  Directories:'));\n      dirs.forEach(dir => {\n        const exists = fs.existsSync(path.join(docsPath, dir));\n        const icon = exists ? chalk.green('✓') : chalk.gray('○');\n        console.log(`    ${icon} ${dir}/`);\n      });\n\n      console.log();\n    });\n\n  return command;\n}\n"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,11 @@
+/**
+ * Graph Command
+ *
+ * Generate and update knowledge graph from documentation.
+ */
+import { Command } from 'commander';
+/**
+ * Create graph command
+ */
+export declare function createGraphCommand(): Command;
+//# sourceMappingURL=graph.d.ts.map

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

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