@weavelogic/knowledge-graph-agent 0.1.0

package/dist/generators/graph-generator.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Knowledge Graph Generator
+ *
+ * Scans documentation and generates a knowledge graph from markdown files.
+ */
+import type { GeneratorOptions } from '../core/types.js';
+import { KnowledgeGraphManager } from '../core/graph.js';
+/**
+ * Generate knowledge graph from docs directory
+ */
+export declare function generateGraph(options: GeneratorOptions): Promise<{
+    graph: KnowledgeGraphManager;
+    stats: {
+        filesScanned: number;
+        nodesCreated: number;
+        edgesCreated: number;
+        errors: string[];
+    };
+}>;
+/**
+ * Generate graph and save to database
+ */
+export declare function generateAndSave(options: GeneratorOptions, dbPath: string): Promise<{
+    success: boolean;
+    stats: {
+        filesScanned: number;
+        nodesCreated: number;
+        edgesCreated: number;
+        errors: string[];
+    };
+}>;
+/**
+ * Generate graph from existing database (incremental update)
+ */
+export declare function updateGraph(dbPath: string, docsRoot: string): Promise<{
+    added: number;
+    updated: number;
+    removed: number;
+    errors: string[];
+}>;
+//# sourceMappingURL=graph-generator.d.ts.map

package/dist/generators/graph-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-generator.d.ts","sourceRoot":"","sources":["../../src/generators/graph-generator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,KAAK,EAMV,gBAAgB,EAEjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AASzD;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC;IACtE,KAAK,EAAE,qBAAqB,CAAC;IAC7B,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;CACH,CAAC,CAwED;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IACT,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE;QACL,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;CACH,CAAC,CA6BD;AAgND;;GAEG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IACT,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC,CA4DD"}

package/dist/generators/graph-generator.js

@@ -0,0 +1,266 @@
+import { readFileSync, statSync } from "fs";
+import { join, basename, relative } from "path";
+import fg from "fast-glob";
+import matter from "gray-matter";
+import { KnowledgeGraphManager } from "../core/graph.js";
+import { KnowledgeGraphDatabase } from "../core/database.js";
+const WIKILINK_PATTERN = /\[\[([^\]|]+)(?:\|([^\]]+))?\]\]/g;
+const MARKDOWN_LINK_PATTERN = /\[([^\]]+)\]\(([^)]+)\)/g;
+async function generateGraph(options) {
+  const { projectRoot, outputPath } = options;
+  const stats = {
+    filesScanned: 0,
+    nodesCreated: 0,
+    edgesCreated: 0,
+    errors: []
+  };
+  const graph = new KnowledgeGraphManager(
+    basename(projectRoot),
+    projectRoot
+  );
+  const files = await fg("**/*.md", {
+    cwd: outputPath,
+    ignore: ["node_modules/**", ".git/**", "_templates/**"],
+    absolute: true
+  });
+  stats.filesScanned = files.length;
+  const nodeMap = /* @__PURE__ */ new Map();
+  for (const filePath of files) {
+    try {
+      const node = await parseMarkdownFile(filePath, outputPath);
+      nodeMap.set(node.id, node);
+      stats.nodesCreated++;
+    } catch (error) {
+      stats.errors.push(`Failed to parse ${filePath}: ${error}`);
+    }
+  }
+  for (const node of nodeMap.values()) {
+    const resolvedLinks = [];
+    for (const link of node.outgoingLinks) {
+      const targetId = resolveLink(link.target, node.path, nodeMap);
+      if (targetId) {
+        resolvedLinks.push({
+          ...link,
+          target: targetId
+        });
+        const targetNode = nodeMap.get(targetId);
+        if (targetNode) {
+          targetNode.incomingLinks.push({
+            target: node.id,
+            type: "backlink",
+            text: node.title
+          });
+        }
+        stats.edgesCreated++;
+      }
+    }
+    node.outgoingLinks = resolvedLinks;
+    graph.addNode(node);
+  }
+  return { graph, stats };
+}
+async function generateAndSave(options, dbPath) {
+  const { graph, stats } = await generateGraph(options);
+  const db = new KnowledgeGraphDatabase(dbPath);
+  try {
+    const nodes = graph.getAllNodes();
+    const edges = graph.getAllEdges();
+    for (const node of nodes) {
+      db.upsertNode(node);
+    }
+    for (const edge of edges) {
+      db.addEdge(edge);
+    }
+    db.setMetadata("lastGenerated", (/* @__PURE__ */ new Date()).toISOString());
+    db.setMetadata("nodeCount", String(stats.nodesCreated));
+    db.setMetadata("edgeCount", String(stats.edgesCreated));
+    return { success: true, stats };
+  } catch (error) {
+    stats.errors.push(`Database error: ${error}`);
+    return { success: false, stats };
+  } finally {
+    db.close();
+  }
+}
+async function parseMarkdownFile(filePath, docsRoot) {
+  const content = readFileSync(filePath, "utf-8");
+  const stat = statSync(filePath);
+  const { data, content: body } = matter(content);
+  const filename = basename(filePath, ".md");
+  const relativePath = relative(docsRoot, filePath);
+  const id = relativePath.replace(/\.md$/, "").replace(/\\/g, "/").replace(/[^a-z0-9/]+/gi, "-").toLowerCase();
+  const outgoingLinks = extractLinks(body);
+  const type = inferNodeType(data.type, relativePath);
+  const status = data.status || "active";
+  const frontmatter = {
+    title: data.title || formatTitle(filename),
+    type,
+    status,
+    tags: Array.isArray(data.tags) ? data.tags : [],
+    category: data.category,
+    description: data.description,
+    created: data.created || stat.birthtime.toISOString().split("T")[0],
+    updated: data.updated || stat.mtime.toISOString().split("T")[0],
+    aliases: data.aliases,
+    related: data.related,
+    ...data
+  };
+  const wordCount = body.replace(/[#*`\[\]()]/g, "").split(/\s+/).filter(Boolean).length;
+  return {
+    id,
+    path: relativePath,
+    filename,
+    title: frontmatter.title || formatTitle(filename),
+    type,
+    status,
+    content: body,
+    frontmatter,
+    tags: frontmatter.tags || [],
+    outgoingLinks,
+    incomingLinks: [],
+    // Will be filled in second pass
+    wordCount,
+    lastModified: stat.mtime
+  };
+}
+function extractLinks(content) {
+  const links = [];
+  const seen = /* @__PURE__ */ new Set();
+  let match;
+  while ((match = WIKILINK_PATTERN.exec(content)) !== null) {
+    const target = match[1].trim();
+    const text = match[2]?.trim();
+    if (!seen.has(target)) {
+      seen.add(target);
+      links.push({
+        target,
+        type: "wikilink",
+        text
+      });
+    }
+  }
+  while ((match = MARKDOWN_LINK_PATTERN.exec(content)) !== null) {
+    const text = match[1].trim();
+    const target = match[2].trim();
+    if (target.startsWith("http://") || target.startsWith("https://")) {
+      continue;
+    }
+    if (!seen.has(target)) {
+      seen.add(target);
+      links.push({
+        target,
+        type: "markdown",
+        text
+      });
+    }
+  }
+  return links;
+}
+function resolveLink(target, currentPath, nodeMap) {
+  const cleanTarget = target.replace(/\.md$/, "").replace(/^\.\//, "").toLowerCase();
+  for (const [id, node] of nodeMap) {
+    if (id === cleanTarget) {
+      return id;
+    }
+    if (node.filename.toLowerCase() === cleanTarget) {
+      return id;
+    }
+    if (node.title.toLowerCase() === cleanTarget) {
+      return id;
+    }
+    if (node.frontmatter.aliases?.some(
+      (a) => a.toLowerCase() === cleanTarget
+    )) {
+      return id;
+    }
+  }
+  const currentDir = currentPath.replace(/[^/]+$/, "");
+  const relativePath = join(currentDir, cleanTarget).replace(/\\/g, "/").replace(/^\//, "");
+  for (const [id, node] of nodeMap) {
+    if (id === relativePath || node.path.replace(/\.md$/, "") === relativePath) {
+      return id;
+    }
+  }
+  return null;
+}
+function inferNodeType(declaredType, path) {
+  const validTypes = [
+    "concept",
+    "technical",
+    "feature",
+    "primitive",
+    "service",
+    "guide",
+    "standard",
+    "integration"
+  ];
+  if (typeof declaredType === "string" && validTypes.includes(declaredType)) {
+    return declaredType;
+  }
+  const pathLower = path.toLowerCase();
+  if (pathLower.includes("concept")) return "concept";
+  if (pathLower.includes("component") || pathLower.includes("technical")) return "technical";
+  if (pathLower.includes("feature")) return "feature";
+  if (pathLower.includes("primitive") || pathLower.includes("integration")) return "primitive";
+  if (pathLower.includes("service") || pathLower.includes("api")) return "service";
+  if (pathLower.includes("guide") || pathLower.includes("tutorial")) return "guide";
+  if (pathLower.includes("standard")) return "standard";
+  if (pathLower.includes("reference")) return "technical";
+  return "concept";
+}
+function formatTitle(filename) {
+  return filename.replace(/-/g, " ").replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+async function updateGraph(dbPath, docsRoot) {
+  const result = {
+    added: 0,
+    updated: 0,
+    removed: 0,
+    errors: []
+  };
+  const db = new KnowledgeGraphDatabase(dbPath);
+  try {
+    const existingNodes = db.getAllNodes();
+    const existingPaths = new Set(existingNodes.map((n) => n.path));
+    const currentFiles = await fg("**/*.md", {
+      cwd: docsRoot,
+      ignore: ["node_modules/**", ".git/**", "_templates/**"]
+    });
+    const currentPaths = new Set(currentFiles);
+    for (const node of existingNodes) {
+      if (!currentPaths.has(node.path)) {
+        db.deleteNode(node.id);
+        result.removed++;
+      }
+    }
+    for (const filePath of currentFiles) {
+      const fullPath = join(docsRoot, filePath);
+      try {
+        const node = await parseMarkdownFile(fullPath, docsRoot);
+        if (existingPaths.has(filePath)) {
+          const existing = existingNodes.find((n) => n.path === filePath);
+          if (existing && node.lastModified > existing.lastModified) {
+            db.deleteNodeEdges(node.id);
+            db.upsertNode(node);
+            result.updated++;
+          }
+        } else {
+          db.upsertNode(node);
+          result.added++;
+        }
+      } catch (error) {
+        result.errors.push(`Failed to process ${filePath}: ${error}`);
+      }
+    }
+    db.setMetadata("lastUpdated", (/* @__PURE__ */ new Date()).toISOString());
+  } finally {
+    db.close();
+  }
+  return result;
+}
+export {
+  generateAndSave,
+  generateGraph,
+  updateGraph
+};
+//# sourceMappingURL=graph-generator.js.map

package/dist/generators/graph-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-generator.js","sources":["../../src/generators/graph-generator.ts"],"sourcesContent":["/**\n * Knowledge Graph Generator\n *\n * Scans documentation and generates a knowledge graph from markdown files.\n */\n\nimport { readFileSync, statSync } from 'fs';\nimport { join, basename, relative, extname } from 'path';\nimport fg from 'fast-glob';\nimport matter from 'gray-matter';\nimport type {\n  KnowledgeNode,\n  NodeType,\n  NodeStatus,\n  NodeLink,\n  NodeFrontmatter,\n  GeneratorOptions,\n  GeneratedDocument,\n} from '../core/types.js';\nimport { KnowledgeGraphManager } from '../core/graph.js';\nimport { KnowledgeGraphDatabase } from '../core/database.js';\n\n/**\n * Link extraction patterns\n */\nconst WIKILINK_PATTERN = /\\[\\[([^\\]|]+)(?:\\|([^\\]]+))?\\]\\]/g;\nconst MARKDOWN_LINK_PATTERN = /\\[([^\\]]+)\\]\\(([^)]+)\\)/g;\n\n/**\n * Generate knowledge graph from docs directory\n */\nexport async function generateGraph(options: GeneratorOptions): Promise<{\n  graph: KnowledgeGraphManager;\n  stats: {\n    filesScanned: number;\n    nodesCreated: number;\n    edgesCreated: number;\n    errors: string[];\n  };\n}> {\n  const { projectRoot, outputPath } = options;\n\n  const stats = {\n    filesScanned: 0,\n    nodesCreated: 0,\n    edgesCreated: 0,\n    errors: [] as string[],\n  };\n\n  // Create graph manager\n  const graph = new KnowledgeGraphManager(\n    basename(projectRoot),\n    projectRoot\n  );\n\n  // Find all markdown files\n  const files = await fg('**/*.md', {\n    cwd: outputPath,\n    ignore: ['node_modules/**', '.git/**', '_templates/**'],\n    absolute: true,\n  });\n\n  stats.filesScanned = files.length;\n\n  // First pass: Create all nodes\n  const nodeMap = new Map<string, KnowledgeNode>();\n\n  for (const filePath of files) {\n    try {\n      const node = await parseMarkdownFile(filePath, outputPath);\n      nodeMap.set(node.id, node);\n      stats.nodesCreated++;\n    } catch (error) {\n      stats.errors.push(`Failed to parse ${filePath}: ${error}`);\n    }\n  }\n\n  // Second pass: Resolve links and add to graph\n  for (const node of nodeMap.values()) {\n    // Resolve outgoing links\n    const resolvedLinks: NodeLink[] = [];\n\n    for (const link of node.outgoingLinks) {\n      // Try to resolve the link target\n      const targetId = resolveLink(link.target, node.path, nodeMap);\n\n      if (targetId) {\n        resolvedLinks.push({\n          ...link,\n          target: targetId,\n        });\n\n        // Create backlink in target node\n        const targetNode = nodeMap.get(targetId);\n        if (targetNode) {\n          targetNode.incomingLinks.push({\n            target: node.id,\n            type: 'backlink',\n            text: node.title,\n          });\n        }\n\n        stats.edgesCreated++;\n      }\n    }\n\n    node.outgoingLinks = resolvedLinks;\n    graph.addNode(node);\n  }\n\n  return { graph, stats };\n}\n\n/**\n * Generate graph and save to database\n */\nexport async function generateAndSave(\n  options: GeneratorOptions,\n  dbPath: string\n): Promise<{\n  success: boolean;\n  stats: {\n    filesScanned: number;\n    nodesCreated: number;\n    edgesCreated: number;\n    errors: string[];\n  };\n}> {\n  const { graph, stats } = await generateGraph(options);\n\n  // Save to database\n  const db = new KnowledgeGraphDatabase(dbPath);\n\n  try {\n    const nodes = graph.getAllNodes();\n    const edges = graph.getAllEdges();\n\n    for (const node of nodes) {\n      db.upsertNode(node);\n    }\n\n    for (const edge of edges) {\n      db.addEdge(edge);\n    }\n\n    db.setMetadata('lastGenerated', new Date().toISOString());\n    db.setMetadata('nodeCount', String(stats.nodesCreated));\n    db.setMetadata('edgeCount', String(stats.edgesCreated));\n\n    return { success: true, stats };\n  } catch (error) {\n    stats.errors.push(`Database error: ${error}`);\n    return { success: false, stats };\n  } finally {\n    db.close();\n  }\n}\n\n/**\n * Parse a markdown file into a knowledge node\n */\nasync function parseMarkdownFile(\n  filePath: string,\n  docsRoot: string\n): Promise<KnowledgeNode> {\n  const content = readFileSync(filePath, 'utf-8');\n  const stat = statSync(filePath);\n  const { data, content: body } = matter(content);\n\n  // Extract filename and path\n  const filename = basename(filePath, '.md');\n  const relativePath = relative(docsRoot, filePath);\n\n  // Generate ID from relative path\n  const id = relativePath\n    .replace(/\\.md$/, '')\n    .replace(/\\\\/g, '/')\n    .replace(/[^a-z0-9/]+/gi, '-')\n    .toLowerCase();\n\n  // Extract links from content\n  const outgoingLinks = extractLinks(body);\n\n  // Determine node type from frontmatter or path\n  const type = inferNodeType(data.type, relativePath);\n  const status = (data.status as NodeStatus) || 'active';\n\n  // Build frontmatter\n  const frontmatter: NodeFrontmatter = {\n    title: data.title || formatTitle(filename),\n    type,\n    status,\n    tags: Array.isArray(data.tags) ? data.tags : [],\n    category: data.category,\n    description: data.description,\n    created: data.created || stat.birthtime.toISOString().split('T')[0],\n    updated: data.updated || stat.mtime.toISOString().split('T')[0],\n    aliases: data.aliases,\n    related: data.related,\n    ...data,\n  };\n\n  // Calculate word count\n  const wordCount = body\n    .replace(/[#*`\\[\\]()]/g, '')\n    .split(/\\s+/)\n    .filter(Boolean).length;\n\n  return {\n    id,\n    path: relativePath,\n    filename,\n    title: frontmatter.title || formatTitle(filename),\n    type,\n    status,\n    content: body,\n    frontmatter,\n    tags: frontmatter.tags || [],\n    outgoingLinks,\n    incomingLinks: [], // Will be filled in second pass\n    wordCount,\n    lastModified: stat.mtime,\n  };\n}\n\n/**\n * Extract links from markdown content\n */\nfunction extractLinks(content: string): NodeLink[] {\n  const links: NodeLink[] = [];\n  const seen = new Set<string>();\n\n  // Extract wikilinks\n  let match: RegExpExecArray | null;\n  while ((match = WIKILINK_PATTERN.exec(content)) !== null) {\n    const target = match[1].trim();\n    const text = match[2]?.trim();\n\n    if (!seen.has(target)) {\n      seen.add(target);\n      links.push({\n        target,\n        type: 'wikilink',\n        text,\n      });\n    }\n  }\n\n  // Extract markdown links (only internal ones)\n  while ((match = MARKDOWN_LINK_PATTERN.exec(content)) !== null) {\n    const text = match[1].trim();\n    const target = match[2].trim();\n\n    // Skip external URLs\n    if (target.startsWith('http://') || target.startsWith('https://')) {\n      continue;\n    }\n\n    if (!seen.has(target)) {\n      seen.add(target);\n      links.push({\n        target,\n        type: 'markdown',\n        text,\n      });\n    }\n  }\n\n  return links;\n}\n\n/**\n * Resolve a link target to a node ID\n */\nfunction resolveLink(\n  target: string,\n  currentPath: string,\n  nodeMap: Map<string, KnowledgeNode>\n): string | null {\n  // Clean target\n  const cleanTarget = target\n    .replace(/\\.md$/, '')\n    .replace(/^\\.\\//, '')\n    .toLowerCase();\n\n  // Try direct match\n  for (const [id, node] of nodeMap) {\n    // Match by ID\n    if (id === cleanTarget) {\n      return id;\n    }\n\n    // Match by filename\n    if (node.filename.toLowerCase() === cleanTarget) {\n      return id;\n    }\n\n    // Match by title\n    if (node.title.toLowerCase() === cleanTarget) {\n      return id;\n    }\n\n    // Match by alias\n    if (node.frontmatter.aliases?.some(\n      a => a.toLowerCase() === cleanTarget\n    )) {\n      return id;\n    }\n  }\n\n  // Try relative path resolution\n  const currentDir = currentPath.replace(/[^/]+$/, '');\n  const relativePath = join(currentDir, cleanTarget)\n    .replace(/\\\\/g, '/')\n    .replace(/^\\//, '');\n\n  for (const [id, node] of nodeMap) {\n    if (id === relativePath || node.path.replace(/\\.md$/, '') === relativePath) {\n      return id;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Infer node type from frontmatter or path\n */\nfunction inferNodeType(declaredType: unknown, path: string): NodeType {\n  // Use declared type if valid\n  const validTypes: NodeType[] = [\n    'concept', 'technical', 'feature', 'primitive',\n    'service', 'guide', 'standard', 'integration',\n  ];\n\n  if (typeof declaredType === 'string' && validTypes.includes(declaredType as NodeType)) {\n    return declaredType as NodeType;\n  }\n\n  // Infer from path\n  const pathLower = path.toLowerCase();\n\n  if (pathLower.includes('concept')) return 'concept';\n  if (pathLower.includes('component') || pathLower.includes('technical')) return 'technical';\n  if (pathLower.includes('feature')) return 'feature';\n  if (pathLower.includes('primitive') || pathLower.includes('integration')) return 'primitive';\n  if (pathLower.includes('service') || pathLower.includes('api')) return 'service';\n  if (pathLower.includes('guide') || pathLower.includes('tutorial')) return 'guide';\n  if (pathLower.includes('standard')) return 'standard';\n  if (pathLower.includes('reference')) return 'technical';\n\n  return 'concept'; // Default\n}\n\n/**\n * Format filename as title\n */\nfunction formatTitle(filename: string): string {\n  return filename\n    .replace(/-/g, ' ')\n    .replace(/_/g, ' ')\n    .replace(/\\b\\w/g, c => c.toUpperCase());\n}\n\n/**\n * Generate graph from existing database (incremental update)\n */\nexport async function updateGraph(\n  dbPath: string,\n  docsRoot: string\n): Promise<{\n  added: number;\n  updated: number;\n  removed: number;\n  errors: string[];\n}> {\n  const result = {\n    added: 0,\n    updated: 0,\n    removed: 0,\n    errors: [] as string[],\n  };\n\n  const db = new KnowledgeGraphDatabase(dbPath);\n\n  try {\n    // Get existing nodes\n    const existingNodes = db.getAllNodes();\n    const existingPaths = new Set(existingNodes.map(n => n.path));\n\n    // Find current files\n    const currentFiles = await fg('**/*.md', {\n      cwd: docsRoot,\n      ignore: ['node_modules/**', '.git/**', '_templates/**'],\n    });\n    const currentPaths = new Set(currentFiles);\n\n    // Find removed files\n    for (const node of existingNodes) {\n      if (!currentPaths.has(node.path)) {\n        db.deleteNode(node.id);\n        result.removed++;\n      }\n    }\n\n    // Process current files\n    for (const filePath of currentFiles) {\n      const fullPath = join(docsRoot, filePath);\n\n      try {\n        const node = await parseMarkdownFile(fullPath, docsRoot);\n\n        if (existingPaths.has(filePath)) {\n          // Check if file was modified\n          const existing = existingNodes.find(n => n.path === filePath);\n          if (existing && node.lastModified > existing.lastModified) {\n            db.deleteNodeEdges(node.id);\n            db.upsertNode(node);\n            result.updated++;\n          }\n        } else {\n          db.upsertNode(node);\n          result.added++;\n        }\n      } catch (error) {\n        result.errors.push(`Failed to process ${filePath}: ${error}`);\n      }\n    }\n\n    db.setMetadata('lastUpdated', new Date().toISOString());\n  } finally {\n    db.close();\n  }\n\n  return result;\n}\n"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Knowledge Graph Agent
+ *
+ * NPM library for creating and managing knowledge graphs for Claude Code.
+ *
+ * @packageDocumentation
+ */
+export { KnowledgeGraphManager, createKnowledgeGraph, } from './core/graph.js';
+export { KnowledgeGraphDatabase, createDatabase, } from './core/database.js';
+export type { NodeType, NodeStatus, NodeLink, NodeFrontmatter, KnowledgeNode, GraphEdge, GraphMetadata, GraphStats, KnowledgeGraph, KGConfig, ConfigSchema, GeneratorOptions, GeneratedDocument, DocsInitOptions, DocsInitResult, MemoryEntry, SyncResult, ClaudeMdSection, ClaudeMdTemplate, ClaudeMdGeneratorOptions, } from './core/types.js';
+export { generateGraph, generateAndSave, updateGraph, } from './generators/graph-generator.js';
+export { initDocs, docsExist, getDocsPath, } from './generators/docs-init.js';
+export { generateClaudeMd, updateClaudeMd, addSection, getSectionTemplate, listSectionTemplates, } from './generators/claude-md.js';
+export { ClaudeFlowIntegration, createClaudeFlowIntegration, generateMcpConfig, } from './integrations/claude-flow.js';
+export { createCLI } from './cli/index.js';
+/**
+ * Quick start function for programmatic usage
+ *
+ * @example
+ * ```typescript
+ * import { quickInit } from '@weave-nn/knowledge-graph-agent';
+ *
+ * await quickInit({
+ *   projectRoot: '/path/to/project',
+ *   docsPath: 'docs',
+ * });
+ * ```
+ */
+export declare function quickInit(options: {
+    projectRoot: string;
+    docsPath?: string;
+    generateGraph?: boolean;
+    updateClaudeMd?: boolean;
+}): Promise<{
+    success: boolean;
+    docsCreated: boolean;
+    graphGenerated: boolean;
+    claudeMdUpdated: boolean;
+    errors: string[];
+}>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,sBAAsB,EACtB,cAAc,GACf,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAEV,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,eAAe,EACf,aAAa,EAGb,SAAS,EACT,aAAa,EACb,UAAU,EACV,cAAc,EAGd,QAAQ,EACR,YAAY,EAGZ,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,cAAc,EAGd,WAAW,EACX,UAAU,EAGV,eAAe,EACf,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,aAAa,EACb,eAAe,EACf,WAAW,GACZ,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EACL,QAAQ,EACR,SAAS,EACT,WAAW,GACZ,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,qBAAqB,EACrB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC,CAgFD"}

package/dist/index.js

@@ -0,0 +1,99 @@
+import { createDatabase } from "./core/database.js";
+import { KnowledgeGraphDatabase } from "./core/database.js";
+import { docsExist, initDocs } from "./generators/docs-init.js";
+import { getDocsPath } from "./generators/docs-init.js";
+import { generateAndSave } from "./generators/graph-generator.js";
+import { generateGraph, updateGraph } from "./generators/graph-generator.js";
+import { updateClaudeMd } from "./generators/claude-md.js";
+import { addSection, generateClaudeMd, getSectionTemplate, listSectionTemplates } from "./generators/claude-md.js";
+import { KnowledgeGraphManager, createKnowledgeGraph } from "./core/graph.js";
+import { ClaudeFlowIntegration, createClaudeFlowIntegration, generateMcpConfig } from "./integrations/claude-flow.js";
+import { createCLI } from "./cli/index.js";
+async function quickInit(options) {
+  const {
+    projectRoot,
+    docsPath = "docs",
+    generateGraph: genGraph = true,
+    updateClaudeMd: updateClaude = true
+  } = options;
+  const result = {
+    success: true,
+    docsCreated: false,
+    graphGenerated: false,
+    claudeMdUpdated: false,
+    errors: []
+  };
+  try {
+    const { existsSync, mkdirSync, writeFileSync } = await import("fs");
+    const { join } = await import("path");
+    const kgDir = join(projectRoot, ".kg");
+    if (!existsSync(kgDir)) {
+      mkdirSync(kgDir, { recursive: true });
+    }
+    const dbPath = join(kgDir, "knowledge.db");
+    const db = createDatabase(dbPath);
+    db.setMetadata("initialized", (/* @__PURE__ */ new Date()).toISOString());
+    if (!docsExist(projectRoot, docsPath)) {
+      const docsResult = await initDocs({
+        projectRoot,
+        docsPath,
+        includeExamples: true,
+        detectFramework: true
+      });
+      result.docsCreated = docsResult.success;
+      if (!docsResult.success) {
+        result.errors.push(...docsResult.errors);
+      }
+    }
+    if (genGraph && docsExist(projectRoot, docsPath)) {
+      const graphResult = await generateAndSave(
+        {
+          projectRoot,
+          outputPath: join(projectRoot, docsPath)
+        },
+        dbPath
+      );
+      result.graphGenerated = graphResult.success;
+      if (!graphResult.success) {
+        result.errors.push(...graphResult.stats.errors);
+      }
+    }
+    if (updateClaude) {
+      const claudeResult = await updateClaudeMd({
+        projectRoot,
+        includeKnowledgeGraph: true,
+        includeClaudeFlow: true
+      });
+      result.claudeMdUpdated = claudeResult.created || claudeResult.updated;
+    }
+    db.close();
+    result.success = result.errors.length === 0;
+  } catch (error) {
+    result.success = false;
+    result.errors.push(String(error));
+  }
+  return result;
+}
+export {
+  ClaudeFlowIntegration,
+  KnowledgeGraphDatabase,
+  KnowledgeGraphManager,
+  addSection,
+  createCLI,
+  createClaudeFlowIntegration,
+  createDatabase,
+  createKnowledgeGraph,
+  docsExist,
+  generateAndSave,
+  generateClaudeMd,
+  generateGraph,
+  generateMcpConfig,
+  getDocsPath,
+  getSectionTemplate,
+  initDocs,
+  listSectionTemplates,
+  quickInit,
+  updateClaudeMd,
+  updateGraph
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/index.ts"],"sourcesContent":["/**\n * Knowledge Graph Agent\n *\n * NPM library for creating and managing knowledge graphs for Claude Code.\n *\n * @packageDocumentation\n */\n\n// Internal imports for quickInit\nimport { createDatabase as _createDatabase } from './core/database.js';\nimport { initDocs as _initDocs, docsExist as _docsExist } from './generators/docs-init.js';\nimport { generateAndSave as _generateAndSave } from './generators/graph-generator.js';\nimport { updateClaudeMd as _updateClaudeMd } from './generators/claude-md.js';\n\n// Core exports\nexport {\n  KnowledgeGraphManager,\n  createKnowledgeGraph,\n} from './core/graph.js';\n\nexport {\n  KnowledgeGraphDatabase,\n  createDatabase,\n} from './core/database.js';\n\nexport type {\n  // Node types\n  NodeType,\n  NodeStatus,\n  NodeLink,\n  NodeFrontmatter,\n  KnowledgeNode,\n\n  // Graph types\n  GraphEdge,\n  GraphMetadata,\n  GraphStats,\n  KnowledgeGraph,\n\n  // Configuration\n  KGConfig,\n  ConfigSchema,\n\n  // Generator types\n  GeneratorOptions,\n  GeneratedDocument,\n  DocsInitOptions,\n  DocsInitResult,\n\n  // Integration types\n  MemoryEntry,\n  SyncResult,\n\n  // CLAUDE.md types\n  ClaudeMdSection,\n  ClaudeMdTemplate,\n  ClaudeMdGeneratorOptions,\n} from './core/types.js';\n\n// Generator exports\nexport {\n  generateGraph,\n  generateAndSave,\n  updateGraph,\n} from './generators/graph-generator.js';\n\nexport {\n  initDocs,\n  docsExist,\n  getDocsPath,\n} from './generators/docs-init.js';\n\nexport {\n  generateClaudeMd,\n  updateClaudeMd,\n  addSection,\n  getSectionTemplate,\n  listSectionTemplates,\n} from './generators/claude-md.js';\n\n// Integration exports\nexport {\n  ClaudeFlowIntegration,\n  createClaudeFlowIntegration,\n  generateMcpConfig,\n} from './integrations/claude-flow.js';\n\n// CLI export\nexport { createCLI } from './cli/index.js';\n\n/**\n * Quick start function for programmatic usage\n *\n * @example\n * ```typescript\n * import { quickInit } from '@weave-nn/knowledge-graph-agent';\n *\n * await quickInit({\n *   projectRoot: '/path/to/project',\n *   docsPath: 'docs',\n * });\n * ```\n */\nexport async function quickInit(options: {\n  projectRoot: string;\n  docsPath?: string;\n  generateGraph?: boolean;\n  updateClaudeMd?: boolean;\n}): Promise<{\n  success: boolean;\n  docsCreated: boolean;\n  graphGenerated: boolean;\n  claudeMdUpdated: boolean;\n  errors: string[];\n}> {\n  const {\n    projectRoot,\n    docsPath = 'docs',\n    generateGraph: genGraph = true,\n    updateClaudeMd: updateClaude = true,\n  } = options;\n\n  const result = {\n    success: true,\n    docsCreated: false,\n    graphGenerated: false,\n    claudeMdUpdated: false,\n    errors: [] as string[],\n  };\n\n  try {\n    // Initialize docs if needed\n    const { existsSync, mkdirSync, writeFileSync } = await import('fs');\n    const { join } = await import('path');\n\n    // Create .kg directory\n    const kgDir = join(projectRoot, '.kg');\n    if (!existsSync(kgDir)) {\n      mkdirSync(kgDir, { recursive: true });\n    }\n\n    // Initialize database\n    const dbPath = join(kgDir, 'knowledge.db');\n    const db = _createDatabase(dbPath);\n    db.setMetadata('initialized', new Date().toISOString());\n\n    // Initialize docs\n    if (!_docsExist(projectRoot, docsPath)) {\n      const docsResult = await _initDocs({\n        projectRoot,\n        docsPath,\n        includeExamples: true,\n        detectFramework: true,\n      });\n      result.docsCreated = docsResult.success;\n      if (!docsResult.success) {\n        result.errors.push(...docsResult.errors);\n      }\n    }\n\n    // Generate graph\n    if (genGraph && _docsExist(projectRoot, docsPath)) {\n      const graphResult = await _generateAndSave(\n        {\n          projectRoot,\n          outputPath: join(projectRoot, docsPath),\n        },\n        dbPath\n      );\n      result.graphGenerated = graphResult.success;\n      if (!graphResult.success) {\n        result.errors.push(...graphResult.stats.errors);\n      }\n    }\n\n    // Update CLAUDE.md\n    if (updateClaude) {\n      const claudeResult = await _updateClaudeMd({\n        projectRoot,\n        includeKnowledgeGraph: true,\n        includeClaudeFlow: true,\n      });\n      result.claudeMdUpdated = claudeResult.created || claudeResult.updated;\n    }\n\n    db.close();\n    result.success = result.errors.length === 0;\n\n  } catch (error) {\n    result.success = false;\n    result.errors.push(String(error));\n  }\n\n  return result;\n}\n"],"names":["_createDatabase","_docsExist","_initDocs","_generateAndSave","_updateClaudeMd"],"mappings":";;;;;;;;;;;AAuGA,eAAsB,UAAU,SAW7B;AACD,QAAM;AAAA,IACJ;AAAA,IACA,WAAW;AAAA,IACX,eAAe,WAAW;AAAA,IAC1B,gBAAgB,eAAe;AAAA,EAAA,IAC7B;AAEJ,QAAM,SAAS;AAAA,IACb,SAAS;AAAA,IACT,aAAa;AAAA,IACb,gBAAgB;AAAA,IAChB,iBAAiB;AAAA,IACjB,QAAQ,CAAA;AAAA,EAAC;AAGX,MAAI;AAEF,UAAM,EAAE,YAAY,WAAW,kBAAkB,MAAM,OAAO,IAAI;AAClE,UAAM,EAAE,KAAA,IAAS,MAAM,OAAO,MAAM;AAGpC,UAAM,QAAQ,KAAK,aAAa,KAAK;AACrC,QAAI,CAAC,WAAW,KAAK,GAAG;AACtB,gBAAU,OAAO,EAAE,WAAW,KAAA,CAAM;AAAA,IACtC;AAGA,UAAM,SAAS,KAAK,OAAO,cAAc;AACzC,UAAM,KAAKA,eAAgB,MAAM;AACjC,OAAG,YAAY,gBAAe,oBAAI,KAAA,GAAO,aAAa;AAGtD,QAAI,CAACC,UAAW,aAAa,QAAQ,GAAG;AACtC,YAAM,aAAa,MAAMC,SAAU;AAAA,QACjC;AAAA,QACA;AAAA,QACA,iBAAiB;AAAA,QACjB,iBAAiB;AAAA,MAAA,CAClB;AACD,aAAO,cAAc,WAAW;AAChC,UAAI,CAAC,WAAW,SAAS;AACvB,eAAO,OAAO,KAAK,GAAG,WAAW,MAAM;AAAA,MACzC;AAAA,IACF;AAGA,QAAI,YAAYD,UAAW,aAAa,QAAQ,GAAG;AACjD,YAAM,cAAc,MAAME;AAAAA,QACxB;AAAA,UACE;AAAA,UACA,YAAY,KAAK,aAAa,QAAQ;AAAA,QAAA;AAAA,QAExC;AAAA,MAAA;AAEF,aAAO,iBAAiB,YAAY;AACpC,UAAI,CAAC,YAAY,SAAS;AACxB,eAAO,OAAO,KAAK,GAAG,YAAY,MAAM,MAAM;AAAA,MAChD;AAAA,IACF;AAGA,QAAI,cAAc;AAChB,YAAM,eAAe,MAAMC,eAAgB;AAAA,QACzC;AAAA,QACA,uBAAuB;AAAA,QACvB,mBAAmB;AAAA,MAAA,CACpB;AACD,aAAO,kBAAkB,aAAa,WAAW,aAAa;AAAA,IAChE;AAEA,OAAG,MAAA;AACH,WAAO,UAAU,OAAO,OAAO,WAAW;AAAA,EAE5C,SAAS,OAAO;AACd,WAAO,UAAU;AACjB,WAAO,OAAO,KAAK,OAAO,KAAK,CAAC;AAAA,EAClC;AAEA,SAAO;AACT;"}

package/dist/integrations/claude-flow.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Claude-Flow Integration
+ *
+ * Integrates knowledge graph with claude-flow memory and coordination.
+ */
+import type { KnowledgeNode, SyncResult } from '../core/types.js';
+import { KnowledgeGraphDatabase } from '../core/database.js';
+/**
+ * Claude-Flow client configuration
+ */
+export interface ClaudeFlowConfig {
+    namespace: string;
+    defaultTTL?: number;
+    syncOnChange?: boolean;
+}
+/**
+ * Claude-Flow Knowledge Graph Integration
+ *
+ * Syncs knowledge graph data with claude-flow memory for
+ * cross-session persistence and agent coordination.
+ */
+export declare class ClaudeFlowIntegration {
+    private config;
+    constructor(config: ClaudeFlowConfig);
+    /**
+     * Sync all nodes to claude-flow memory
+     */
+    syncToMemory(db: KnowledgeGraphDatabase): Promise<SyncResult>;
+    /**
+     * Sync a single node to memory
+     */
+    syncNode(node: KnowledgeNode): Promise<boolean>;
+    /**
+     * Generate memory retrieval commands
+     */
+    generateRetrievalCommands(): string[];
+    /**
+     * Generate hook commands for automatic sync
+     */
+    generateHookCommands(): string[];
+    /**
+     * Convert node to memory entry format
+     */
+    private nodeToMemoryEntry;
+    /**
+     * Extract summary from content
+     */
+    private extractSummary;
+    /**
+     * Build tag index from nodes
+     */
+    private buildTagIndex;
+}
+/**
+ * Create claude-flow integration instance
+ */
+export declare function createClaudeFlowIntegration(config: ClaudeFlowConfig): ClaudeFlowIntegration;
+/**
+ * Generate MCP configuration for CLAUDE.md
+ */
+export declare function generateMcpConfig(namespace: string): string;
+//# sourceMappingURL=claude-flow.d.ts.map

package/dist/integrations/claude-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-flow.d.ts","sourceRoot":"","sources":["../../src/integrations/claude-flow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,aAAa,EAGb,UAAU,EACX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAkBD;;;;;GAKG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAA6B;gBAE/B,MAAM,EAAE,gBAAgB;IAQpC;;OAEG;IACG,YAAY,CAAC,EAAE,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC;IAsFnE;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBrD;;OAEG;IACH,yBAAyB,IAAI,MAAM,EAAE;IAgBrC;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAahC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,cAAc;IA8BtB;;OAEG;IACH,OAAO,CAAC,aAAa;CActB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,gBAAgB,GACvB,qBAAqB,CAEvB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA4C3D"}