tskb 0.0.1

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

@@ -0,0 +1,55 @@
+/**
+ * Configuration for the extract command
+ */
+export interface ExtractConfig {
+    /**
+     * Glob pattern to match documentation files
+     */
+    pattern: string;
+    /**
+     * Output file path for the generated graph JSON
+     */
+    output: string;
+    /**
+     * Path to tsconfig.json
+     */
+    tsconfig: string;
+}
+/**
+ * Generates a knowledge graph from tskb documentation files.
+ *
+ * PIPELINE OVERVIEW:
+ * Orchestrates the complete knowledge graph extraction process through six stages:
+ *
+ * 1. FILE DISCOVERY
+ *    Locates all documentation files matching the glob pattern.
+ *
+ * 2. PROGRAM INITIALIZATION
+ *    Loads files into TypeScript's compiler, providing access to the parsed AST
+ *    (Abstract Syntax Tree) and type checker.
+ *
+ * 3. REGISTRY EXTRACTION
+ *    Scans the AST for `declare global { namespace tskb { ... } }` declarations.
+ *    Extracts Context/Module/Term definitions to build the canonical vocabulary—
+ *    the authoritative names and descriptions for your codebase.
+ *
+ * 4. DOCUMENTATION EXTRACTION
+ *    Processes each file's AST to extract documentation by traversing the JSX
+ *    tree to extract text and references, capturing content and its relationships
+ *    to vocabulary items.
+ *
+ * 5. GRAPH CONSTRUCTION
+ *    Merges registry and documentation into a unified graph structure with
+ *    nodes (entities) and edges (relationships), creating a queryable network.
+ *
+ * 6. SERIALIZATION
+ *    Writes the graph to JSON format for consumption by AI tools and documentation systems.
+ *
+ * OUTPUT:
+ * A comprehensive knowledge graph mapping your codebase's architecture, entities,
+ * and their interconnections—enabling AI to understand your project structure.
+ *
+ * @param config - Extract configuration (pattern, output, tsconfig)
+ */
+export declare function build(config: ExtractConfig): Promise<void>;
+//# sourceMappingURL=build.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/build.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAoFhE"}

package/dist/cli/commands/build.js

@@ -0,0 +1,105 @@
+import { globSync } from "glob";
+import fs from "node:fs";
+import path from "node:path";
+import { createProgram } from "../../typescript/index.js";
+import { extractRegistry, extractDocs } from "../../core/extraction/index.js";
+import { buildGraph } from "../../core/graph/index.js";
+/**
+ * Generates a knowledge graph from tskb documentation files.
+ *
+ * PIPELINE OVERVIEW:
+ * Orchestrates the complete knowledge graph extraction process through six stages:
+ *
+ * 1. FILE DISCOVERY
+ *    Locates all documentation files matching the glob pattern.
+ *
+ * 2. PROGRAM INITIALIZATION
+ *    Loads files into TypeScript's compiler, providing access to the parsed AST
+ *    (Abstract Syntax Tree) and type checker.
+ *
+ * 3. REGISTRY EXTRACTION
+ *    Scans the AST for `declare global { namespace tskb { ... } }` declarations.
+ *    Extracts Context/Module/Term definitions to build the canonical vocabulary—
+ *    the authoritative names and descriptions for your codebase.
+ *
+ * 4. DOCUMENTATION EXTRACTION
+ *    Processes each file's AST to extract documentation by traversing the JSX
+ *    tree to extract text and references, capturing content and its relationships
+ *    to vocabulary items.
+ *
+ * 5. GRAPH CONSTRUCTION
+ *    Merges registry and documentation into a unified graph structure with
+ *    nodes (entities) and edges (relationships), creating a queryable network.
+ *
+ * 6. SERIALIZATION
+ *    Writes the graph to JSON format for consumption by AI tools and documentation systems.
+ *
+ * OUTPUT:
+ * A comprehensive knowledge graph mapping your codebase's architecture, entities,
+ * and their interconnections—enabling AI to understand your project structure.
+ *
+ * @param config - Extract configuration (pattern, output, tsconfig)
+ */
+export async function build(config) {
+    console.log("tskb build");
+    console.log(`   Pattern: ${config.pattern}`);
+    console.log(`   Tsconfig: ${config.tsconfig}`);
+    console.log("");
+    // Find all matching files
+    const files = globSync(config.pattern, { absolute: true, nodir: true });
+    console.log(`Found ${files.length} documentation files`);
+    if (files.length === 0) {
+        console.warn("No files found matching pattern");
+        return;
+    }
+    // Create TypeScript program
+    console.log("Creating TypeScript program...");
+    const program = createProgram(files, config.tsconfig);
+    // Extract registry (vocabulary)
+    console.log("Extracting registry (Folders, Modules, Terms)...");
+    const tsconfigDir = path.dirname(path.resolve(config.tsconfig));
+    // Use rootDir from tsconfig if available, otherwise use tsconfig directory
+    const compilerOptions = program.getCompilerOptions();
+    const baseDir = compilerOptions.rootDir
+        ? path.resolve(tsconfigDir, compilerOptions.rootDir)
+        : tsconfigDir;
+    console.log(`   Base directory: ${baseDir}`);
+    const registry = extractRegistry(program, baseDir, config.tsconfig);
+    console.log(`   ├─ ${registry.folders.size} folders`);
+    // Report path resolution status
+    const foldersWithPaths = Array.from(registry.folders.values()).filter((c) => c.path);
+    const validPaths = foldersWithPaths.filter((c) => c.pathExists).length;
+    const invalidPaths = foldersWithPaths.filter((c) => !c.pathExists).length;
+    if (foldersWithPaths.length > 0) {
+        console.log(`   │  └─ Paths: ${validPaths} valid, ${invalidPaths > 0 ? `${invalidPaths} missing` : "0 missing"}`);
+    }
+    console.log(`   ├─ ${registry.modules.size} modules`);
+    // Report module import path resolution status
+    const modulesWithImports = Array.from(registry.modules.values()).filter((m) => m.importPath);
+    const validImports = modulesWithImports.filter((m) => m.pathExists).length;
+    const invalidImports = modulesWithImports.filter((m) => !m.pathExists).length;
+    if (modulesWithImports.length > 0) {
+        console.log(`   │  └─ Imports: ${validImports} valid, ${invalidImports > 0 ? `${invalidImports} missing` : "0 missing"}`);
+    }
+    console.log(`   └─ ${registry.terms.size} terms`);
+    // Extract documentation
+    console.log("Extracting documentation...");
+    const docs = extractDocs(program, new Set(files), baseDir);
+    console.log(`└─ ${docs.length} docs`);
+    // Build knowledge graph
+    console.log("Building knowledge graph...");
+    const graph = buildGraph(registry, docs, baseDir);
+    console.log(`   ├─ ${graph.metadata.stats.folderCount} folder nodes`);
+    console.log(`   ├─ ${graph.metadata.stats.moduleCount} module nodes`);
+    console.log(`   ├─ ${graph.metadata.stats.exportCount} export nodes`);
+    console.log(`   ├─ ${graph.metadata.stats.termCount} term nodes`);
+    console.log(`   ├─ ${graph.metadata.stats.docCount} doc nodes`);
+    console.log(`   └─ ${graph.metadata.stats.edgeCount} edges`);
+    // Write output
+    console.log(`Writing graph to ${config.output}...`);
+    fs.mkdirSync(path.dirname(config.output), { recursive: true });
+    fs.writeFileSync(config.output, JSON.stringify(graph, null, 2), "utf-8");
+    console.log("");
+    console.log("Done!");
+}
+//# sourceMappingURL=build.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Query the knowledge graph for nodes matching the search term
+ *
+ * @param graphPath - Path to the knowledge graph JSON file
+ * @param searchTerm - Search term to match against nodes
+ * @param concise - Output concise format optimized for AI consumption (default: true)
+ * @returns Array of matching nodes with their edges
+ */
+export declare function query(graphPath: string, searchTerm: string, concise?: boolean): Promise<void>;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/query.ts"],"names":[],"mappings":"AA0EA;;;;;;;GAOG;AACH,wBAAsB,KAAK,CACzB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,OAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAoBf"}

package/dist/cli/commands/query.js

@@ -0,0 +1,399 @@
+import fs from "node:fs";
+/**
+ * Query the knowledge graph for nodes matching the search term
+ *
+ * @param graphPath - Path to the knowledge graph JSON file
+ * @param searchTerm - Search term to match against nodes
+ * @param concise - Output concise format optimized for AI consumption (default: true)
+ * @returns Array of matching nodes with their edges
+ */
+export async function query(graphPath, searchTerm, concise = true) {
+    // Load the knowledge graph
+    if (!fs.existsSync(graphPath)) {
+        console.error(`Error: Graph file not found: ${graphPath}`);
+        process.exit(1);
+    }
+    const graphJson = fs.readFileSync(graphPath, "utf-8");
+    const graph = JSON.parse(graphJson);
+    const matches = searchGraph(graph, searchTerm, concise);
+    // Output results wrapper
+    const response = {
+        query: searchTerm,
+        results: matches,
+        resultCount: matches.length,
+    };
+    console.log(JSON.stringify(response, null, 2));
+}
+/**
+ * Search across all nodes in the graph
+ */
+function searchGraph(graph, searchTerm, concise) {
+    const matches = [];
+    const lowerSearchTerm = searchTerm.toLowerCase();
+    // Search folders
+    for (const [id, node] of Object.entries(graph.nodes.folders)) {
+        const result = matchNode(id, node, lowerSearchTerm, graph.edges, graph, concise);
+        if (result)
+            matches.push(result);
+    }
+    // Search modules
+    for (const [id, node] of Object.entries(graph.nodes.modules)) {
+        const result = matchNode(id, node, lowerSearchTerm, graph.edges, graph, concise);
+        if (result)
+            matches.push(result);
+    }
+    // Search terms
+    for (const [id, node] of Object.entries(graph.nodes.terms)) {
+        const result = matchNode(id, node, lowerSearchTerm, graph.edges, graph, concise);
+        if (result)
+            matches.push(result);
+    }
+    // Search exports
+    for (const [id, node] of Object.entries(graph.nodes.exports)) {
+        const result = matchNode(id, node, lowerSearchTerm, graph.edges, graph, concise);
+        if (result)
+            matches.push(result);
+    }
+    // Search docs
+    for (const [id, node] of Object.entries(graph.nodes.docs)) {
+        const result = matchNode(id, node, lowerSearchTerm, graph.edges, graph, concise);
+        if (result)
+            matches.push(result);
+    }
+    // Sort by score (highest first)
+    return matches.sort((a, b) => b.match.score - a.match.score);
+}
+/**
+ * Check if a node matches the search term and build enhanced match result
+ */
+function matchNode(id, node, searchTerm, allEdges, graph, concise) {
+    const matchedFields = [];
+    let score = 0;
+    // Search in ID
+    if (id.toLowerCase().includes(searchTerm)) {
+        matchedFields.push("id");
+        score += 10; // ID matches are high priority
+    }
+    // Search in description
+    if ("desc" in node && node.desc.toLowerCase().includes(searchTerm)) {
+        matchedFields.push("desc");
+        score += 5;
+    }
+    // Search in paths
+    if ("path" in node && node.path && node.path.toLowerCase().includes(searchTerm)) {
+        matchedFields.push("path");
+        score += 8;
+    }
+    if ("resolvedPath" in node &&
+        node.resolvedPath &&
+        node.resolvedPath.toLowerCase().includes(searchTerm)) {
+        matchedFields.push("resolvedPath");
+        score += 8;
+    }
+    if ("filePath" in node && node.filePath.toLowerCase().includes(searchTerm)) {
+        matchedFields.push("filePath");
+        score += 8;
+    }
+    // Search in doc content
+    if (node.type === "doc" && node.content.toLowerCase().includes(searchTerm)) {
+        matchedFields.push("content");
+        score += 3; // Lower priority for content matches
+    }
+    // Search in import paths
+    if ("importPath" in node &&
+        node.importPath &&
+        node.importPath.toLowerCase().includes(searchTerm)) {
+        matchedFields.push("importPath");
+        score += 7;
+    }
+    // If no matches, return null
+    if (matchedFields.length === 0) {
+        return null;
+    }
+    // Get edges for this node
+    const edges = getNodeEdges(allEdges, id);
+    // Build enhanced response
+    return buildQueryMatch(id, node, matchedFields, score, edges, graph, concise);
+}
+/**
+ * Get all edges connected to a node
+ */
+function getNodeEdges(allEdges, nodeId) {
+    const incoming = [];
+    const outgoing = [];
+    for (const edge of allEdges) {
+        if (edge.to === nodeId) {
+            incoming.push(edge);
+        }
+        if (edge.from === nodeId) {
+            outgoing.push(edge);
+        }
+    }
+    return { incoming, outgoing };
+}
+/**
+ * Build enhanced query match result with all context
+ */
+function buildQueryMatch(id, node, matchedFields, score, edges, graph, concise) {
+    if (concise) {
+        // Concise mode: minimal output for AI consumption
+        const parent = findParent(edges, graph);
+        const primaryFile = extractPrimaryFile(node);
+        const relatedFiles = extractRelatedFiles(node, edges, graph, primaryFile).slice(0, 3);
+        return {
+            match: {
+                id,
+                type: node.type,
+                desc: "desc" in node ? node.desc : undefined,
+                score,
+                matchReason: matchedFields.join(", "),
+            },
+            context: {
+                hierarchy: buildHierarchy(id, node, edges, graph),
+                parent,
+            },
+            files: {
+                primary: primaryFile,
+                related: relatedFiles,
+            },
+            relationships: buildRelationships(edges, graph),
+            documentation: extractDocumentation(id, node, edges, graph, true),
+            suggestions: generateSuggestions(node, edges, graph, matchedFields),
+        };
+    }
+    // Verbose mode: full context
+    return {
+        match: {
+            id,
+            type: node.type,
+            desc: "desc" in node ? node.desc : undefined,
+            score,
+            matchReason: `Matched in ${matchedFields.join(", ")}`,
+        },
+        context: {
+            hierarchy: buildHierarchy(id, node, edges, graph),
+            parent: findParent(edges, graph),
+        },
+        files: extractFiles(node, edges, graph),
+        relationships: buildRelationships(edges, graph),
+        documentation: extractDocumentation(id, node, edges, graph, false),
+        suggestions: generateSuggestions(node, edges, graph, matchedFields),
+    };
+}
+/**
+ * Build hierarchy breadcrumb from root to current node
+ */
+function buildHierarchy(id, node, edges, graph) {
+    const hierarchy = [];
+    // Find belongs-to or contained-by relationships
+    const parentEdge = edges.outgoing.find((e) => e.type === "belongs-to") ||
+        edges.incoming.find((e) => e.type === "contains");
+    if (parentEdge) {
+        const parentId = parentEdge.type === "belongs-to" ? parentEdge.to : parentEdge.from;
+        const parentNode = findNodeById(parentId, graph);
+        if (parentNode) {
+            // Recursively build parent hierarchy
+            const parentEdges = getNodeEdges(graph.edges, parentId);
+            const parentHierarchy = buildHierarchy(parentId, parentNode, parentEdges, graph);
+            hierarchy.push(...parentHierarchy);
+        }
+    }
+    hierarchy.push(id);
+    return hierarchy;
+}
+/**
+ * Find parent node from edges
+ */
+function findParent(edges, graph) {
+    const parentEdge = edges.outgoing.find((e) => e.type === "belongs-to") ||
+        edges.incoming.find((e) => e.type === "contains");
+    if (!parentEdge)
+        return undefined;
+    const parentId = parentEdge.type === "belongs-to" ? parentEdge.to : parentEdge.from;
+    const parentNode = findNodeById(parentId, graph);
+    if (!parentNode)
+        return undefined;
+    return {
+        id: parentId,
+        type: parentNode.type,
+        desc: "desc" in parentNode ? parentNode.desc : undefined,
+    };
+}
+/**
+ * Extract primary file from node
+ */
+function extractPrimaryFile(node) {
+    if ("resolvedPath" in node && node.resolvedPath) {
+        return node.resolvedPath;
+    }
+    else if ("filePath" in node) {
+        return node.filePath;
+    }
+    else if ("path" in node && node.path) {
+        return node.path;
+    }
+    return undefined;
+}
+/**
+ * Extract related files from connected nodes
+ */
+function extractRelatedFiles(node, edges, graph, primaryFile) {
+    const related = [];
+    for (const edge of [...edges.incoming, ...edges.outgoing]) {
+        const relatedId = edge.from === node.id ? edge.to : edge.from;
+        const relatedNode = findNodeById(relatedId, graph);
+        if (!relatedNode)
+            continue;
+        const filePath = extractPrimaryFile(relatedNode);
+        if (filePath && filePath !== primaryFile && !related.includes(filePath)) {
+            related.push(filePath);
+        }
+    }
+    return related;
+}
+/**
+ * Extract primary and related files (verbose mode)
+ */
+function extractFiles(node, edges, graph) {
+    const primary = extractPrimaryFile(node);
+    const related = extractRelatedFiles(node, edges, graph, primary);
+    return { primary, related };
+}
+/**
+ * Build relationship categorization
+ */
+function buildRelationships(edges, graph) {
+    const uses = [];
+    const usedBy = [];
+    const contains = [];
+    const belongsTo = [];
+    // Process outgoing edges
+    for (const edge of edges.outgoing) {
+        const targetNode = findNodeById(edge.to, graph);
+        if (!targetNode)
+            continue;
+        const relatedNode = {
+            id: edge.to,
+            type: targetNode.type,
+            desc: "desc" in targetNode ? targetNode.desc : undefined,
+            relationship: edge.type,
+        };
+        if (edge.type === "references") {
+            uses.push(relatedNode);
+        }
+        else if (edge.type === "contains") {
+            contains.push(relatedNode);
+        }
+        else if (edge.type === "belongs-to") {
+            belongsTo.push(relatedNode);
+        }
+    }
+    // Process incoming edges
+    for (const edge of edges.incoming) {
+        const sourceNode = findNodeById(edge.from, graph);
+        if (!sourceNode)
+            continue;
+        const relatedNode = {
+            id: edge.from,
+            type: sourceNode.type,
+            desc: "desc" in sourceNode ? sourceNode.desc : undefined,
+            relationship: edge.type,
+        };
+        if (edge.type === "references") {
+            usedBy.push(relatedNode);
+        }
+        else if (edge.type === "contains") {
+            belongsTo.push(relatedNode);
+        }
+    }
+    return { uses, usedBy, contains, belongsTo };
+}
+/**
+ * Extract documentation context
+ */
+function extractDocumentation(id, node, edges, graph, concise) {
+    const relatedDocs = [];
+    let primary;
+    const excerptLength = concise ? 100 : 200;
+    // If this is a doc node, use it as primary
+    if (node.type === "doc") {
+        const excerpt = node.content.substring(0, excerptLength).replace(/\s+/g, " ").trim();
+        primary = {
+            file: node.filePath,
+            excerpt: excerpt + (node.content.length > excerptLength ? "..." : ""),
+        };
+    }
+    // Find related doc nodes
+    const maxRelatedDocs = concise ? 2 : 10;
+    for (const edge of edges.incoming) {
+        if (edge.type === "references" && relatedDocs.length < maxRelatedDocs) {
+            const docNode = graph.nodes.docs[edge.from];
+            if (docNode) {
+                relatedDocs.push({
+                    id: edge.from,
+                    title: docNode.filePath.split("/").pop() || edge.from,
+                });
+                // Use first doc as primary if we don't have one
+                if (!primary) {
+                    const excerpt = docNode.content.substring(0, excerptLength).replace(/\s+/g, " ").trim();
+                    primary = {
+                        file: docNode.filePath,
+                        excerpt: excerpt + (docNode.content.length > excerptLength ? "..." : ""),
+                    };
+                }
+            }
+        }
+    }
+    return { primary, relatedDocs };
+}
+/**
+ * Generate AI suggestions
+ */
+function generateSuggestions(node, edges, graph, matchedFields) {
+    const readNext = [];
+    const keywords = [];
+    // Extract keywords from matched fields
+    if (matchedFields.includes("id")) {
+        keywords.push(...node.id.toLowerCase().split(/[.\-_]/));
+    }
+    if ("desc" in node) {
+        keywords.push(...node.desc.toLowerCase().split(/\s+/).slice(0, 5));
+    }
+    // Generate read next suggestions
+    if ("resolvedPath" in node && node.resolvedPath) {
+        readNext.push(`Read ${node.resolvedPath} to understand the implementation`);
+    }
+    // Suggest reading parent context
+    const parentEdge = edges.outgoing.find((e) => e.type === "belongs-to");
+    if (parentEdge) {
+        const parentNode = findNodeById(parentEdge.to, graph);
+        if (parentNode && "resolvedPath" in parentNode && parentNode.resolvedPath) {
+            readNext.push(`Check ${parentNode.resolvedPath} for parent context`);
+        }
+    }
+    // Suggest reading documentation
+    for (const edge of edges.incoming) {
+        if (edge.type === "references") {
+            const docNode = graph.nodes.docs[edge.from];
+            if (docNode) {
+                readNext.push(`Review ${docNode.filePath} for architecture context`);
+            }
+        }
+    }
+    return {
+        readNext: readNext.slice(0, 3), // Limit to top 3
+        keywords: [...new Set(keywords)].filter((k) => k.length > 2).slice(0, 5), // Dedupe and limit
+    };
+}
+/**
+ * Find any node by ID across all node types
+ */
+function findNodeById(id, graph) {
+    return (graph.nodes.folders[id] ||
+        graph.nodes.modules[id] ||
+        graph.nodes.terms[id] ||
+        graph.nodes.exports[id] ||
+        graph.nodes.docs[id] ||
+        null);
+}
+//# sourceMappingURL=query.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Visualize command - generates a Graphviz DOT file from a knowledge graph JSON.
+ *
+ * This is a thin CLI wrapper around the core visualization module.
+ *
+ * @param graphPath - Path to the knowledge graph JSON file
+ * @param outputPath - Path where the DOT file should be written
+ */
+export declare function visualize(graphPath: string, outputPath: string): Promise<void>;
+//# sourceMappingURL=visualize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"visualize.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/visualize.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,wBAAsB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAkBpE"}

package/dist/cli/commands/visualize.js

@@ -0,0 +1,26 @@
+import { generateDot } from "../../core/visualization/index.js";
+import fs from "node:fs/promises";
+/**
+ * Visualize command - generates a Graphviz DOT file from a knowledge graph JSON.
+ *
+ * This is a thin CLI wrapper around the core visualization module.
+ *
+ * @param graphPath - Path to the knowledge graph JSON file
+ * @param outputPath - Path where the DOT file should be written
+ */
+export async function visualize(graphPath, outputPath) {
+    console.log("Visualizing knowledge graph...");
+    console.log(`   Input: ${graphPath}`);
+    console.log(`   Output: ${outputPath}`);
+    // Read the knowledge graph
+    const graphJson = await fs.readFile(graphPath, "utf-8");
+    const graph = JSON.parse(graphJson);
+    // Generate DOT content
+    const dot = generateDot(graph);
+    // Write DOT file
+    await fs.writeFile(outputPath, dot, "utf-8");
+    console.log("DOT file generated!");
+    console.log(`   Render with: dot -Tpng ${outputPath} -o graph.png`);
+    console.log(`   Or view with: xdot ${outputPath}`);
+}
+//# sourceMappingURL=visualize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"visualize.js","sourceRoot":"","sources":["../../../src/cli/commands/visualize.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAChE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,SAAiB,EAAE,UAAkB;IACnE,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,aAAa,SAAS,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,GAAG,CAAC,cAAc,UAAU,EAAE,CAAC,CAAC;IAExC,2BAA2B;IAC3B,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IACxD,MAAM,KAAK,GAAmB,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAEpD,uBAAuB;IACvB,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAE/B,iBAAiB;IACjB,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAE7C,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,6BAA6B,UAAU,eAAe,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,yBAAyB,UAAU,EAAE,CAAC,CAAC;AACrD,CAAC"}