tskb 0.0.1

package/dist/core/extraction/registry.js

@@ -0,0 +1,604 @@
+import ts from "typescript";
+import path from "node:path";
+/**
+ * Extracts the vocabulary (Folders, Modules, Terms) from the TypeScript type system.
+ *
+ * This uses the TypeScript compiler API to resolve the global `tskb` namespace
+ * and extract all declaration-merged interfaces.
+ *
+ * @param program - TypeScript program containing the source files
+ * @param baseDir - Base directory for resolving and storing relative paths (typically tsconfig rootDir)
+ * @param tsconfigPath - Path to tsconfig.json (for reading additional config if needed)
+ * @returns Extracted registry data
+ */
+export function extractRegistry(program, baseDir, tsconfigPath) {
+    const checker = program.getTypeChecker();
+    const registry = {
+        folders: new Map(),
+        modules: new Map(),
+        terms: new Map(),
+        exports: new Map(),
+    };
+    // Use the provided baseDir for all path resolution
+    const baseUrl = baseDir;
+    // Find all source files that might contain tskb declarations
+    for (const sourceFile of program.getSourceFiles()) {
+        // Skip node_modules and lib files
+        if (sourceFile.isDeclarationFile && sourceFile.fileName.includes("node_modules")) {
+            continue;
+        }
+        // Look for global namespace declarations
+        ts.forEachChild(sourceFile, (node) => {
+            if (ts.isModuleDeclaration(node) && node.name.text === "global") {
+                extractFromGlobalNamespace(node, checker, registry, sourceFile, baseDir, baseUrl);
+            }
+        });
+    }
+    return registry;
+}
+/**
+ * Extract tskb interfaces from a global namespace declaration.
+ *
+ * WHAT WE'RE DOING:
+ * Once we find `declare global { ... }`, we need to look inside for `namespace tskb`.
+ * The AST structure is: ModuleDeclaration -> ModuleBlock -> statements[]
+ *
+ * We iterate through all statements looking for another ModuleDeclaration named "tskb".
+ */
+function extractFromGlobalNamespace(globalNode, checker, registry, sourceFile, tsconfigDir, baseUrl) {
+    if (!globalNode.body || !ts.isModuleBlock(globalNode.body))
+        return;
+    // Look for `namespace tskb`
+    for (const statement of globalNode.body.statements) {
+        if (ts.isModuleDeclaration(statement) &&
+            ts.isIdentifier(statement.name) &&
+            statement.name.text === "tskb") {
+            extractFromTskbNamespace(statement, checker, registry, sourceFile, tsconfigDir, baseUrl);
+        }
+    }
+}
+/**
+ * Extract Folders, Modules, Terms from the tskb namespace
+ */
+function extractFromTskbNamespace(tskbNode, checker, registry, sourceFile, tsconfigDir, baseUrl) {
+    if (!tskbNode.body || !ts.isModuleBlock(tskbNode.body))
+        return;
+    for (const statement of tskbNode.body.statements) {
+        if (!ts.isInterfaceDeclaration(statement))
+            continue;
+        const interfaceName = statement.name.text;
+        if (interfaceName === "Folders") {
+            extractFolders(statement, checker, registry, sourceFile, tsconfigDir, baseUrl);
+        }
+        else if (interfaceName === "Modules") {
+            extractModules(statement, checker, registry, sourceFile, tsconfigDir, baseUrl);
+        }
+        else if (interfaceName === "Terms") {
+            extractTerms(statement, checker, registry, sourceFile);
+        }
+        else if (interfaceName == "Exports") {
+            extractExports(statement, checker, registry, sourceFile, tsconfigDir, baseUrl);
+        }
+    }
+}
+/**
+ * Extract all Folders from the Folders interface.
+ *
+ * INTERFACE PARSING:
+ * Given:
+ * ```ts
+ * interface Folders {
+ *   Auth: Folder<{ desc: "Authentication", path: "/auth" }>;
+ *   Billing: Folder<{ desc: "Payment system" }>;
+ * }
+ * ```
+ *
+ * We iterate through each property signature (Auth, Billing, etc.):
+ * 1. Get the property name ("Auth")
+ * 2. Get the type node (Folder<{...}>)
+ * 3. Call extractFolderType to pull out desc and path literals
+ * 4. Store in registry.folders Map: "Auth" -> { desc, path }
+ */
+function extractFolders(interfaceNode, checker, registry, sourceFile, tsconfigDir, baseUrl) {
+    for (const member of interfaceNode.members) {
+        if (!ts.isPropertySignature(member))
+            continue;
+        if (!member.name || (!ts.isIdentifier(member.name) && !ts.isStringLiteral(member.name)))
+            continue;
+        const folderName = member.name.text;
+        const type = member.type;
+        if (!type)
+            continue;
+        // Extract Folder<{ desc: "...", path: "..." }>
+        const folderData = extractFolderType(type, checker);
+        if (!folderData) {
+            // Invalid Folder definition - throw descriptive error
+            const typeText = type.getText();
+            throw new Error(`Invalid Folder definition for "${folderName}" in ${sourceFile.fileName}:\n` +
+                `  Expected: Folder<{ desc: string; path: string }>\n` +
+                `  Received: ${typeText}\n` +
+                `  All properties in the Folders interface must use the Folder<...> helper type.`);
+        }
+        if (folderData) {
+            // Resolve and validate path if present
+            let resolvedPath;
+            let pathExists = false;
+            if (folderData.path) {
+                // Strip leading slash from path (folders use "/path" convention)
+                // Also strip trailing slash for consistent checking
+                let normalizedPath = folderData.path.startsWith("/")
+                    ? folderData.path.slice(1)
+                    : folderData.path;
+                normalizedPath = normalizedPath.replace(/\/$/, "");
+                // Try to resolve path from baseUrl (tsconfig baseUrl/rootDir)
+                const absoluteFromBaseUrl = path.resolve(baseUrl, normalizedPath);
+                const fileExistsCheck = ts.sys.fileExists(absoluteFromBaseUrl);
+                const dirExistsCheck = ts.sys.directoryExists(absoluteFromBaseUrl);
+                if (fileExistsCheck || dirExistsCheck) {
+                    // Store as relative path from baseUrl
+                    resolvedPath = path.relative(baseUrl, absoluteFromBaseUrl).replace(/\\/g, "/");
+                    pathExists = true;
+                }
+                else {
+                    // Try relative to the source file where Folder was declared
+                    const sourceFileDir = path.dirname(sourceFile.fileName);
+                    const absoluteFromSourceFile = path.resolve(sourceFileDir, normalizedPath);
+                    if (ts.sys.fileExists(absoluteFromSourceFile) ||
+                        ts.sys.directoryExists(absoluteFromSourceFile)) {
+                        // Store as relative path from baseUrl
+                        resolvedPath = path.relative(baseUrl, absoluteFromSourceFile).replace(/\\/g, "/");
+                        pathExists = true;
+                    }
+                    else {
+                        // Path doesn't exist - throw error
+                        throw new Error(`Folder path not found for "${folderName}" in ${sourceFile.fileName}:\n` +
+                            `  Specified path: "${folderData.path}"\n` +
+                            `  Tried resolving from:\n` +
+                            `    - Repository root (${baseUrl}): ${absoluteFromBaseUrl}\n` +
+                            `    - Source file directory (${sourceFileDir}): ${absoluteFromSourceFile}\n` +
+                            `  Neither path exists. Please check the path is correct.`);
+                    }
+                }
+            }
+            registry.folders.set(folderName, {
+                ...folderData,
+                resolvedPath,
+                pathExists,
+            });
+        }
+    }
+}
+/**
+ * Extract desc and path from Folder<{ ... }> type.
+ *
+ * THE TRICK: We're reading literal string values from type definitions.
+ * Given: Folder<{ desc: "Auth management", path: "/auth" }>
+ *
+ * We need to:
+ * 1. Check it's a TypeReferenceNode (generic type)
+ * 2. Get the first type argument (the object literal)
+ * 3. Walk the object's properties
+ * 4. For each property, if it's a literal type (string), extract the actual string value
+ *
+ * TypeScript represents `desc: "Auth management"` as:
+ * PropertySignature -> LiteralTypeNode -> StringLiteral -> .text = "Auth management"
+ */
+function extractFolderType(typeNode, checker) {
+    // Handle Folder<{ desc: "...", path: "..." }>
+    if (!ts.isTypeReferenceNode(typeNode))
+        return null;
+    const typeArgs = typeNode.typeArguments;
+    if (!typeArgs || typeArgs.length === 0)
+        return null;
+    const objectType = typeArgs[0];
+    if (!ts.isTypeLiteralNode(objectType))
+        return null;
+    let desc = "";
+    let path;
+    for (const member of objectType.members) {
+        if (!ts.isPropertySignature(member))
+            continue;
+        if (!member.name || (!ts.isIdentifier(member.name) && !ts.isStringLiteral(member.name)))
+            continue;
+        const propName = member.name.text;
+        const propType = member.type;
+        if (propName === "desc" && propType && ts.isLiteralTypeNode(propType)) {
+            desc = propType.literal.text;
+        }
+        else if (propName === "path" && propType && ts.isLiteralTypeNode(propType)) {
+            path = propType.literal.text;
+        }
+    }
+    return desc ? { desc, path } : null;
+}
+/**
+ * Extract all Modules from the Modules interface.
+ *
+ * SAME PATTERN AS FOLDERS:
+ * Given:
+ * ```ts
+ * interface Modules {
+ *   AuthService: Module<{ desc: "Handles auth", type: typeof import("@/auth") }>;
+ * }
+ * ```
+ *
+ * Extract module name + desc + type (typeof import) and resolve import paths.
+ */
+function extractModules(interfaceNode, checker, registry, sourceFile, tsconfigDir, baseUrl) {
+    for (const member of interfaceNode.members) {
+        if (!ts.isPropertySignature(member))
+            continue;
+        if (!member.name || (!ts.isIdentifier(member.name) && !ts.isStringLiteral(member.name)))
+            continue;
+        const moduleName = member.name.text;
+        const type = member.type;
+        if (!type)
+            continue;
+        const moduleData = extractModuleType(type, checker);
+        if (!moduleData) {
+            const typeText = type.getText();
+            throw new Error(`Invalid Module definition for "${moduleName}" in ${sourceFile.fileName}:\n` +
+                `  Expected: Module<{ desc: string; type: typeof import("...") }>\n` +
+                `  Received: ${typeText}\n` +
+                `  All properties in the Modules interface must use the Module<...> helper type with a valid import path.\n` +
+                `  The 'type' field must be 'typeof import("path/to/module")' - plain types like 'any' are not allowed.\n` +
+                `  If you want to use Export<...>, define it in an 'interface Exports' instead.`);
+        }
+        if (moduleData) {
+            // Resolve and validate import path if present
+            let resolvedPath;
+            let pathExists = false;
+            if (moduleData.importPath) {
+                // Try to resolve from baseUrl (tsconfig baseUrl) first
+                const absoluteFromBaseUrl = resolveModulePath(moduleData.importPath, baseUrl);
+                if (absoluteFromBaseUrl) {
+                    const checkBaseUrl = checkPathExists(absoluteFromBaseUrl);
+                    if (checkBaseUrl.exists) {
+                        // Store as relative path from baseUrl
+                        resolvedPath = path.relative(baseUrl, checkBaseUrl.actualPath).replace(/\\/g, "/");
+                        pathExists = true;
+                    }
+                    else {
+                        // Try relative to the source file where Module was declared
+                        const sourceFileDir = path.dirname(sourceFile.fileName);
+                        const absoluteFromSourceFile = resolveModulePath(moduleData.importPath, sourceFileDir);
+                        if (absoluteFromSourceFile) {
+                            const checkSourceFile = checkPathExists(absoluteFromSourceFile);
+                            if (checkSourceFile.exists) {
+                                // Store as relative path from baseUrl
+                                resolvedPath = path
+                                    .relative(baseUrl, checkSourceFile.actualPath)
+                                    .replace(/\\/g, "/");
+                                pathExists = true;
+                            }
+                            else {
+                                // Path doesn't exist, store relative to baseUrl
+                                resolvedPath = path.relative(baseUrl, absoluteFromBaseUrl).replace(/\\/g, "/");
+                            }
+                        }
+                    }
+                }
+            }
+            registry.modules.set(moduleName, {
+                ...moduleData,
+                resolvedPath,
+                pathExists,
+            });
+        }
+    }
+}
+/**
+ * Extract desc and type from Module<{ ... }> type.
+ *
+ * EXTRACTS IMPORT PATHS:
+ * We're looking for: Module<{ desc: "...", type: typeof import("...") }>
+ * The import path can be:
+ * - Relative: "./auth" or "../services/auth"
+ * - Absolute from tsconfig paths: "@/auth" or "@electron-main/auth"
+ * Walk the type arguments -> object literal -> property values.
+ */
+function extractModuleType(typeNode, checker) {
+    if (!ts.isTypeReferenceNode(typeNode))
+        return null;
+    const typeArgs = typeNode.typeArguments;
+    if (!typeArgs || typeArgs.length === 0)
+        return null;
+    const objectType = typeArgs[0];
+    if (!ts.isTypeLiteralNode(objectType))
+        return null;
+    let desc = "";
+    let typeSignature;
+    let importPath;
+    for (const member of objectType.members) {
+        if (!ts.isPropertySignature(member))
+            continue;
+        if (!member.name || (!ts.isIdentifier(member.name) && !ts.isStringLiteral(member.name)))
+            continue;
+        const propName = member.name.text;
+        const propType = member.type;
+        if (propName === "desc" && propType && ts.isLiteralTypeNode(propType)) {
+            desc = propType.literal.text;
+        }
+        else if (propName === "type" && propType) {
+            // Get the full type text
+            typeSignature = propType.getText();
+            // Try to extract import path from typeof import("...")
+            importPath = extractImportPath(propType);
+            // Enforce that modules must have import paths
+            if (!importPath) {
+                return null; // Invalid module - will trigger error in extractModules
+            }
+        }
+    }
+    return desc && importPath ? { desc, type: typeSignature, importPath } : null;
+}
+/**
+ * Extract all Terms from the Terms interface.
+ *
+ * SIMPLER STRUCTURE:
+ * Terms just map to string descriptions, no complex generics:
+ * ```ts
+ * interface Terms {
+ *   JWT: Term<"JSON Web Token">;
+ *   OAuth: Term<"Open Authorization 2.0">;
+ * }
+ * ```
+ *
+ * We extract: termName -> description string.
+ */
+function extractTerms(interfaceNode, checker, registry, sourceFile) {
+    for (const member of interfaceNode.members) {
+        if (!ts.isPropertySignature(member))
+            continue;
+        if (!member.name || (!ts.isIdentifier(member.name) && !ts.isStringLiteral(member.name)))
+            continue;
+        const termName = member.name.text;
+        const type = member.type;
+        if (!type)
+            continue;
+        const desc = extractTermType(type);
+        if (!desc) {
+            const typeText = type.getText();
+            throw new Error(`Invalid Term definition for "${termName}" in ${sourceFile.fileName}:\n` +
+                `  Expected: string literal type (e.g., "description text")\n` +
+                `  Received: ${typeText}\n` +
+                `  All properties in the Terms interface must be string literals.`);
+        }
+        if (desc) {
+            registry.terms.set(termName, desc);
+        }
+    }
+}
+/**
+ * Extract description from Term<"..."> type
+ */
+function extractTermType(typeNode) {
+    if (!ts.isTypeReferenceNode(typeNode))
+        return null;
+    const typeArgs = typeNode.typeArguments;
+    if (!typeArgs || typeArgs.length === 0)
+        return null;
+    const descType = typeArgs[0];
+    if (ts.isLiteralTypeNode(descType) && ts.isStringLiteral(descType.literal)) {
+        return descType.literal.text;
+    }
+    return null;
+}
+/**
+ * Extract all Exports from the Exports interface.
+ *
+ * SAME PATTERN AS MODULES:
+ * Given:
+ * ```ts
+ * interface Exports {
+ *   API_BASE_URL: Export<{ desc: "Base URL constant", type: typeof import("@/config/constants").API_BASE_URL }>;
+ *   useAuth: Export<{ desc: "Auth hook", type: typeof import("@/hooks/useAuth").useAuth }>;
+ * }
+ * ```
+ *
+ * Extract export name + desc + type (typeof import) and resolve import paths.
+ */
+function extractExports(interfaceNode, checker, registry, sourceFile, tsconfigDir, baseUrl) {
+    for (const member of interfaceNode.members) {
+        if (!ts.isPropertySignature(member))
+            continue;
+        if (!member.name || (!ts.isIdentifier(member.name) && !ts.isStringLiteral(member.name)))
+            continue;
+        const exportName = member.name.text;
+        const type = member.type;
+        if (!type)
+            continue;
+        const exportData = extractExportType(type, checker);
+        if (!exportData) {
+            const typeText = type.getText();
+            throw new Error(`Invalid Export definition for "${exportName}" in ${sourceFile.fileName}:\n` +
+                `  Expected: Export<{ desc: string; type: unknown }>\n` +
+                `  Received: ${typeText}\n` +
+                `  All properties in the Exports interface must use the Export<...> helper type.`);
+        }
+        if (exportData) {
+            // Resolve and validate import path if present
+            let resolvedPath;
+            let pathExists = false;
+            if (exportData.importPath) {
+                // Try to resolve from baseUrl (tsconfig baseUrl) first
+                const absoluteFromBaseUrl = resolveModulePath(exportData.importPath, baseUrl);
+                if (absoluteFromBaseUrl) {
+                    const checkBaseUrl = checkPathExists(absoluteFromBaseUrl);
+                    if (checkBaseUrl.exists) {
+                        // Store as relative path from baseUrl
+                        resolvedPath = path.relative(baseUrl, checkBaseUrl.actualPath).replace(/\\/g, "/");
+                        pathExists = true;
+                    }
+                    else {
+                        // Try relative to the source file where Export was declared
+                        const sourceFileDir = path.dirname(sourceFile.fileName);
+                        const absoluteFromSourceFile = resolveModulePath(exportData.importPath, sourceFileDir);
+                        if (absoluteFromSourceFile) {
+                            const checkSourceFile = checkPathExists(absoluteFromSourceFile);
+                            if (checkSourceFile.exists) {
+                                // Store as relative path from baseUrl
+                                resolvedPath = path
+                                    .relative(baseUrl, checkSourceFile.actualPath)
+                                    .replace(/\\/g, "/");
+                                pathExists = true;
+                            }
+                            else {
+                                // Path doesn't exist, store relative to baseUrl
+                                resolvedPath = path.relative(baseUrl, absoluteFromBaseUrl).replace(/\\/g, "/");
+                            }
+                        }
+                    }
+                }
+            }
+            registry.exports.set(exportName, {
+                ...exportData,
+                resolvedPath,
+                pathExists,
+            });
+        }
+    }
+}
+/**
+ * Extract desc and type from Export<{ ... }> type.
+ *
+ * EXTRACTS IMPORT PATHS:
+ * We're looking for: Export<{ desc: "...", type: typeof import("...").exportName }>
+ * The import path can be:
+ * - Relative: "./auth" or "../services/auth"
+ * - Absolute from tsconfig paths: "@/auth" or "@electron-main/auth"
+ * Walk the type arguments -> object literal -> property values.
+ */
+function extractExportType(typeNode, checker) {
+    if (!ts.isTypeReferenceNode(typeNode))
+        return null;
+    const typeArgs = typeNode.typeArguments;
+    if (!typeArgs || typeArgs.length === 0)
+        return null;
+    const objectType = typeArgs[0];
+    if (!ts.isTypeLiteralNode(objectType))
+        return null;
+    let desc = "";
+    let typeSignature;
+    let importPath;
+    for (const member of objectType.members) {
+        if (!ts.isPropertySignature(member))
+            continue;
+        if (!member.name || (!ts.isIdentifier(member.name) && !ts.isStringLiteral(member.name)))
+            continue;
+        const propName = member.name.text;
+        const propType = member.type;
+        if (propName === "desc" && propType && ts.isLiteralTypeNode(propType)) {
+            desc = propType.literal.text;
+        }
+        else if (propName === "type" && propType) {
+            // Get the full type text
+            typeSignature = propType.getText();
+            // Try to extract import path from typeof import("...")
+            importPath = extractImportPath(propType);
+        }
+    }
+    return desc ? { desc, type: typeSignature, importPath } : null;
+}
+/**
+ * Extract import path from typeof import("...") expression.
+ *
+ * PARSING IMPORT TYPES:
+ * TypeScript represents `typeof import("@/auth")` as a TypeQueryNode.
+ * We need to walk the AST to find the ImportTypeNode within it.
+ *
+ * @param typeNode - The type node that might contain an import
+ * @returns The import path string, or undefined
+ */
+function extractImportPath(typeNode) {
+    let importPath;
+    // Walk the type node tree looking for ImportTypeNode
+    function visit(node) {
+        if (ts.isImportTypeNode(node)) {
+            const argument = node.argument;
+            // The argument is a LiteralTypeNode with a StringLiteral
+            if (ts.isLiteralTypeNode(argument) && ts.isStringLiteral(argument.literal)) {
+                importPath = argument.literal.text;
+            }
+        }
+        ts.forEachChild(node, visit);
+    }
+    visit(typeNode);
+    return importPath;
+}
+/**
+ * Resolve a module path (which might be relative or use tsconfig path aliases).
+ *
+ * RESOLUTION STRATEGY:
+ * 1. If path starts with . or .., resolve as relative path
+ * 2. If path starts with @, try common tsconfig patterns:
+ *    - @/ -> src/
+ *    - @electron-main/ -> electron-layers/main/src/
+ *    - @electron-renderer/ -> electron-layers/renderer/src/
+ * 3. Otherwise return as-is and let existence check determine validity
+ *
+ * @param importPath - The import path from typeof import("...")
+ * @param baseDir - Base directory to resolve from
+ * @returns Resolved absolute path, or undefined if can't resolve
+ */
+function resolveModulePath(importPath, baseDir) {
+    // Handle relative paths
+    if (importPath.startsWith("./") || importPath.startsWith("../")) {
+        return path.resolve(baseDir, importPath);
+    }
+    // Handle tsconfig path aliases (common patterns in this codebase)
+    if (importPath.startsWith("@/")) {
+        // @/ typically maps to src/
+        const withoutAlias = importPath.replace("@/", "src/");
+        return path.resolve(baseDir, withoutAlias);
+    }
+    if (importPath.startsWith("@electron-main/")) {
+        const withoutAlias = importPath.replace("@electron-main/", "electron-layers/main/src/");
+        return path.resolve(baseDir, withoutAlias);
+    }
+    if (importPath.startsWith("@electron-renderer/")) {
+        const withoutAlias = importPath.replace("@electron-renderer/", "electron-layers/renderer/src/");
+        return path.resolve(baseDir, withoutAlias);
+    }
+    // For other paths (node_modules, etc.), try resolving from baseDir
+    return path.resolve(baseDir, importPath);
+}
+/**
+ * Check if a file or directory exists, trying multiple extensions for files.
+ *
+ * EXTENSION RESOLUTION:
+ * For import paths like "@electron-main/main.js", the actual file might be:
+ * - main.js (as specified)
+ * - main.ts (TypeScript source)
+ * - main.tsx (TypeScript with JSX)
+ * - main/ (directory with index file)
+ *
+ * This function tries all common variations.
+ *
+ * @param absolutePath - The absolute path to check
+ * @returns Object with { exists: boolean, actualPath: string }
+ */
+function checkPathExists(absolutePath) {
+    // Check if it exists as-is (file or directory)
+    if (ts.sys.fileExists(absolutePath) || ts.sys.directoryExists(absolutePath)) {
+        return { exists: true, actualPath: absolutePath };
+    }
+    // If it has an extension, try replacing with TypeScript extensions
+    const ext = path.extname(absolutePath);
+    if (ext) {
+        const basePath = absolutePath.slice(0, -ext.length);
+        const tsExtensions = [".ts", ".tsx", ".mts", ".cts"];
+        for (const tsExt of tsExtensions) {
+            const tsPath = basePath + tsExt;
+            if (ts.sys.fileExists(tsPath)) {
+                return { exists: true, actualPath: tsPath };
+            }
+        }
+    }
+    // Try as a directory
+    if (ts.sys.directoryExists(absolutePath)) {
+        return { exists: true, actualPath: absolutePath };
+    }
+    return { exists: false, actualPath: absolutePath };
+}
+//# sourceMappingURL=registry.js.map

package/dist/core/extraction/registry.js.map

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

package/dist/core/graph/builder.d.ts

@@ -0,0 +1,37 @@
+import type { KnowledgeGraph } from "./types.js";
+import type { ExtractedRegistry } from "../extraction/registry.js";
+import type { ExtractedDoc } from "../extraction/documentation.js";
+/**
+ * Builds a knowledge graph from extracted registry and documentation data.
+ *
+ * GRAPH STRUCTURE:
+ * A knowledge graph has two parts:
+ * 1. NODES: The "things" in your system (Folders, Modules, Terms, Docs)
+ * 2. EDGES: Relationships between nodes ("doc X references module Y")
+ *
+ * BUILDING PROCESS:
+ * 1. Create nodes from registry:
+ *    - Each Folder becomes a FolderNode with { id, desc, path }
+ *    - Each Module becomes a ModuleNode with { id, desc, typeSignature }
+ *    - Each Term becomes a TermNode with { id, desc }
+ *
+ * 2. Create nodes from docs:
+ *    - Each doc file becomes a DocNode with { id, filePath, content }
+ *
+ * 3. Create edges from references:
+ *    - For each doc, look at its references.modules/terms/folders
+ *    - Create an edge: { from: docId, to: moduleId, type: "references" }
+ *
+ * RESULT:
+ * A complete graph that can be queried: "What docs reference Module X?"
+ * "What terms are used in Folder Y?", etc.
+ *
+ * This is what feeds AI tools to understand your architecture.
+ *
+ * @param registry - Extracted vocabulary (Folders, Modules, Terms)
+ * @param docs - Extracted documentation files
+ * @param baseDir - Base directory (from tsconfig) to make paths relative to
+ * @returns Complete knowledge graph ready for JSON export
+ */
+export declare function buildGraph(registry: ExtractedRegistry, docs: ExtractedDoc[], baseDir: string): KnowledgeGraph;
+//# sourceMappingURL=builder.d.ts.map

package/dist/core/graph/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/core/graph/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EAOf,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAGnE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,iBAAiB,EAC3B,IAAI,EAAE,YAAY,EAAE,EACpB,OAAO,EAAE,MAAM,GACd,cAAc,CA6ChB"}