@grafema/core 0.1.0-alpha.5 → 0.2.0-beta

package/dist/errors/GrafemaError.js

@@ -0,0 +1,181 @@
+/**
+ * GrafemaError - Error hierarchy for Grafema
+ *
+ * All errors extend the native JavaScript Error class for compatibility
+ * with PluginResult.errors[] (Error[]).
+ *
+ * Error types:
+ * - ConfigError: Configuration parsing/validation errors (fatal)
+ * - FileAccessError: File system access errors (error)
+ * - LanguageError: Unsupported language/parsing errors (warning)
+ * - DatabaseError: RFDB database errors (fatal)
+ * - PluginError: Plugin execution errors (error)
+ * - AnalysisError: Analysis/timeout errors (error)
+ */
+/**
+ * Abstract base class for all Grafema errors.
+ *
+ * Extends native Error for compatibility with PluginResult.errors[].
+ */
+export class GrafemaError extends Error {
+    context;
+    suggestion;
+    constructor(message, context = {}, suggestion) {
+        super(message);
+        this.name = this.constructor.name;
+        this.context = context;
+        this.suggestion = suggestion;
+        // Ensure proper prototype chain for instanceof checks
+        Object.setPrototypeOf(this, new.target.prototype);
+        // Capture stack trace (V8 specific)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Serialize error to JSON for diagnostics.log
+     */
+    toJSON() {
+        return {
+            code: this.code,
+            severity: this.severity,
+            message: this.message,
+            context: this.context,
+            suggestion: this.suggestion,
+        };
+    }
+}
+/**
+ * Configuration error - config.json parsing, validation, missing required fields
+ *
+ * Severity: fatal (always)
+ * Codes: ERR_CONFIG_INVALID, ERR_CONFIG_MISSING_FIELD
+ */
+export class ConfigError extends GrafemaError {
+    code;
+    severity = 'fatal';
+    constructor(message, code, context = {}, suggestion) {
+        super(message, context, suggestion);
+        this.code = code;
+    }
+}
+/**
+ * File access error - unreadable files, missing git, permissions
+ *
+ * Severity: error (default)
+ * Codes: ERR_FILE_UNREADABLE, ERR_GIT_NOT_FOUND, ERR_GIT_ACCESS_DENIED
+ */
+export class FileAccessError extends GrafemaError {
+    code;
+    severity = 'error';
+    constructor(message, code, context = {}, suggestion) {
+        super(message, context, suggestion);
+        this.code = code;
+    }
+}
+/**
+ * Language error - unsupported file type, unparseable syntax
+ *
+ * Severity: warning (always)
+ * Codes: ERR_UNSUPPORTED_LANG, ERR_PARSE_FAILURE
+ */
+export class LanguageError extends GrafemaError {
+    code;
+    severity = 'warning';
+    constructor(message, code, context = {}, suggestion) {
+        super(message, context, suggestion);
+        this.code = code;
+    }
+}
+/**
+ * Database error - RFDB connection, corruption, lock
+ *
+ * Severity: fatal (always)
+ * Codes: ERR_DATABASE_LOCKED, ERR_DATABASE_CORRUPTED
+ */
+export class DatabaseError extends GrafemaError {
+    code;
+    severity = 'fatal';
+    constructor(message, code, context = {}, suggestion) {
+        super(message, context, suggestion);
+        this.code = code;
+    }
+}
+/**
+ * Plugin error - plugin execution failed, dependency missing
+ *
+ * Severity: error (default)
+ * Codes: ERR_PLUGIN_FAILED, ERR_PLUGIN_DEPENDENCY_MISSING
+ */
+export class PluginError extends GrafemaError {
+    code;
+    severity = 'error';
+    constructor(message, code, context = {}, suggestion) {
+        super(message, context, suggestion);
+        this.code = code;
+    }
+}
+/**
+ * Analysis error - internal analyzer failure, timeout
+ *
+ * Severity: error (default)
+ * Codes: ERR_ANALYSIS_TIMEOUT, ERR_ANALYSIS_INTERNAL
+ */
+export class AnalysisError extends GrafemaError {
+    code;
+    severity = 'error';
+    constructor(message, code, context = {}, suggestion) {
+        super(message, context, suggestion);
+        this.code = code;
+    }
+}
+/**
+ * Validation error - issues found by validators during VALIDATION phase
+ *
+ * Unlike other error classes, ValidationError has CONFIGURABLE severity because
+ * validators report issues of varying importance:
+ * - warning: informational issues (unresolved calls, missing assignments)
+ * - error: problems that may indicate bugs (broken references)
+ * - fatal: critical issues that should fail the analysis
+ *
+ * Codes:
+ * - ERR_UNRESOLVED_CALL: function call doesn't resolve to definition
+ * - ERR_DISCONNECTED_NODES: graph nodes not connected to root
+ * - ERR_DISCONNECTED_NODE: individual disconnected node
+ * - ERR_MISSING_ASSIGNMENT: variable has no ASSIGNED_FROM edge
+ * - ERR_BROKEN_REFERENCE: reference to non-existent node
+ * - ERR_NO_LEAF_NODE: data flow doesn't reach leaf node
+ */
+export class ValidationError extends GrafemaError {
+    code;
+    severity;
+    constructor(message, code, context = {}, suggestion, severity = 'warning') {
+        super(message, context, suggestion);
+        this.code = code;
+        this.severity = severity;
+    }
+}
+/**
+ * Strict mode error - reported when strictMode=true and an enricher
+ * cannot resolve a reference.
+ *
+ * Unlike other errors, StrictModeError is used to collect issues that
+ * would normally be silently skipped. All collected StrictModeErrors
+ * cause analysis to fail after the ENRICHMENT phase completes.
+ *
+ * Severity: fatal (always)
+ * Codes:
+ * - STRICT_UNRESOLVED_METHOD: Method call cannot be resolved to definition
+ * - STRICT_UNRESOLVED_CALL: Function call cannot be resolved to definition
+ * - STRICT_UNRESOLVED_ARGUMENT: Argument cannot be linked to parameter
+ * - STRICT_ALIAS_DEPTH_EXCEEDED: Alias chain too deep (potential cycle)
+ * - STRICT_BROKEN_IMPORT: Import/re-export chain broken
+ */
+export class StrictModeError extends GrafemaError {
+    code;
+    severity = 'fatal';
+    constructor(message, code, context = {}, suggestion) {
+        super(message, context, suggestion);
+        this.code = code;
+    }
+}

package/dist/index.d.ts

@@ -1,6 +1,14 @@
 /**
  * @grafema/core - Core analysis engine for GraphDD
  */
+export { GrafemaError, ConfigError, FileAccessError, LanguageError, DatabaseError, PluginError, AnalysisError, ValidationError, StrictModeError, } from './errors/GrafemaError.js';
+export type { ErrorContext, GrafemaErrorJSON } from './errors/GrafemaError.js';
+export { Logger, ConsoleLogger, createLogger } from './logging/Logger.js';
+export type { LogLevel } from './logging/Logger.js';
+export { DiagnosticCollector, DiagnosticReporter, DiagnosticWriter } from './diagnostics/index.js';
+export type { Diagnostic, DiagnosticInput, ReportOptions, SummaryStats } from './diagnostics/index.js';
+export { loadConfig, DEFAULT_CONFIG } from './config/index.js';
+export type { GrafemaConfig } from './config/index.js';
 export { Orchestrator } from './Orchestrator.js';
 export type { OrchestratorOptions, ProgressCallback, ProgressInfo, ParallelConfig, ServiceInfo, EntrypointInfo, DiscoveryManifest, IndexingUnit, } from './Orchestrator.js';
 export { Plugin } from './plugins/Plugin.js';
@@ -11,19 +19,60 @@ export { RFDBClient } from '@grafema/rfdb-client';
 export { RFDBServerBackend } from './storage/backends/RFDBServerBackend.js';
 export { NodeFactory } from './core/NodeFactory.js';
 export { Profiler } from './core/Profiler.js';
+export { computeSemanticId, parseSemanticId, computeDiscriminator } from './core/SemanticId.js';
+export type { Location, ScopeContext, SemanticIdOptions, ParsedSemanticId, LocatedItem } from './core/SemanticId.js';
+export { ScopeTracker } from './core/ScopeTracker.js';
+export type { ScopeEntry, CountedScopeResult } from './core/ScopeTracker.js';
 export { AnalysisQueue } from './core/AnalysisQueue.js';
+export { ASTWorkerPool, type ModuleInfo as ASTModuleInfo, type ParseResult, type ASTWorkerPoolStats } from './core/ASTWorkerPool.js';
 export { GuaranteeManager } from './core/GuaranteeManager.js';
 export type { GuaranteeGraph } from './core/GuaranteeManager.js';
+export { clearFileNodesIfNeeded, clearServiceNodeIfExists } from './core/FileNodeManager.js';
+export { CoverageAnalyzer } from './core/CoverageAnalyzer.js';
+export type { CoverageResult } from './core/CoverageAnalyzer.js';
+export { FileExplainer } from './core/FileExplainer.js';
+export type { FileExplainResult, EnhancedNode } from './core/FileExplainer.js';
+export { calculateFileHash, calculateFileHashAsync, calculateContentHash } from './core/HashUtils.js';
+export { levenshtein, checkTypoAgainstKnownTypes, resetKnownNodeTypes, getKnownNodeTypes } from './storage/backends/typeValidation.js';
+export { PathValidator } from './validation/PathValidator.js';
+export type { PathValidationResult, EndpointDiff } from './validation/PathValidator.js';
+export { VersionManager, versionManager } from './core/VersionManager.js';
+export type { VersionedNode, VersionConstants, EnrichOptions, ModifiedNodeInfo, ChangesSummary, ClassifyChangesResult } from './core/VersionManager.js';
+export { GraphFreshnessChecker } from './core/GraphFreshnessChecker.js';
+export type { FreshnessGraph, FreshnessResult, StaleModule } from './core/GraphFreshnessChecker.js';
+export { IncrementalReanalyzer } from './core/IncrementalReanalyzer.js';
+export type { ReanalysisOptions, ReanalysisProgress, ReanalysisResult } from './core/IncrementalReanalyzer.js';
 export { GraphAPI } from './api/GraphAPI.js';
 export { GuaranteeAPI } from './api/GuaranteeAPI.js';
 export type { GuaranteeGraphBackend } from './api/GuaranteeAPI.js';
 export { isGuaranteeType } from './core/nodes/NodeKind.js';
+export { IssueNode, type IssueNodeRecord, type IssueSeverity, type IssueType } from './core/nodes/IssueNode.js';
+export { FunctionNode } from './core/nodes/FunctionNode.js';
+export { CallSiteNode } from './core/nodes/CallSiteNode.js';
+export { MethodCallNode } from './core/nodes/MethodCallNode.js';
+export { ScopeNode } from './core/nodes/ScopeNode.js';
+export { ClassNode } from './core/nodes/ClassNode.js';
+export { MethodNode } from './core/nodes/MethodNode.js';
+export { ExportNode } from './core/nodes/ExportNode.js';
+export { VariableDeclarationNode } from './core/nodes/VariableDeclarationNode.js';
+export { ExternalModuleNode } from './core/nodes/ExternalModuleNode.js';
+export { NetworkRequestNode } from './core/nodes/NetworkRequestNode.js';
+export { InterfaceNode, type InterfacePropertyRecord } from './core/nodes/InterfaceNode.js';
+export { TypeNode } from './core/nodes/TypeNode.js';
+export { EnumNode, type EnumMemberRecord } from './core/nodes/EnumNode.js';
+export { DecoratorNode, type DecoratorTargetType } from './core/nodes/DecoratorNode.js';
+export { ExpressionNode, type ExpressionNodeOptions } from './core/nodes/ExpressionNode.js';
+export { ArgumentExpressionNode, type ArgumentExpressionNodeRecord, type ArgumentExpressionNodeOptions } from './core/nodes/ArgumentExpressionNode.js';
+export { ASTVisitor, ImportExportVisitor, VariableVisitor, FunctionVisitor, ClassVisitor, CallExpressionVisitor, TypeScriptVisitor } from './plugins/analysis/ast/visitors/index.js';
+export type { VisitorModule, VisitorCollections, VisitorHandlers, VisitorHandler, VariableInfo, ExtractVariableNamesCallback, TrackVariableAssignmentCallback, AnalyzeFunctionBodyCallback } from './plugins/analysis/ast/visitors/index.js';
+export { getNodeLocation, getLine, getColumn, getEndLocation, UNKNOWN_LOCATION } from './plugins/analysis/ast/utils/location.js';
+export type { NodeLocation } from './plugins/analysis/ast/utils/location.js';
 export { JSModuleIndexer } from './plugins/indexing/JSModuleIndexer.js';
 export { IncrementalModuleIndexer } from './plugins/indexing/IncrementalModuleIndexer.js';
 export { RustModuleIndexer } from './plugins/indexing/RustModuleIndexer.js';
-export { ServiceDetector } from './plugins/indexing/ServiceDetector.js';
 export { JSASTAnalyzer } from './plugins/analysis/JSASTAnalyzer.js';
 export { ExpressRouteAnalyzer } from './plugins/analysis/ExpressRouteAnalyzer.js';
+export { ExpressResponseAnalyzer } from './plugins/analysis/ExpressResponseAnalyzer.js';
 export { ExpressAnalyzer } from './plugins/analysis/ExpressAnalyzer.js';
 export { SocketIOAnalyzer } from './plugins/analysis/SocketIOAnalyzer.js';
 export { DatabaseAnalyzer } from './plugins/analysis/DatabaseAnalyzer.js';
@@ -35,6 +84,7 @@ export { SQLiteAnalyzer } from './plugins/analysis/SQLiteAnalyzer.js';
 export { SystemDbAnalyzer } from './plugins/analysis/SystemDbAnalyzer.js';
 export { IncrementalAnalysisPlugin } from './plugins/analysis/IncrementalAnalysisPlugin.js';
 export { MethodCallResolver } from './plugins/enrichment/MethodCallResolver.js';
+export { ArgumentParameterLinker } from './plugins/enrichment/ArgumentParameterLinker.js';
 export { AliasTracker } from './plugins/enrichment/AliasTracker.js';
 export { ValueDomainAnalyzer } from './plugins/enrichment/ValueDomainAnalyzer.js';
 export { MountPointResolver } from './plugins/enrichment/MountPointResolver.js';
@@ -42,7 +92,14 @@ export { PrefixEvaluator } from './plugins/enrichment/PrefixEvaluator.js';
 export { InstanceOfResolver } from './plugins/enrichment/InstanceOfResolver.js';
 export { HTTPConnectionEnricher } from './plugins/enrichment/HTTPConnectionEnricher.js';
 export { ImportExportLinker } from './plugins/enrichment/ImportExportLinker.js';
+export { FunctionCallResolver } from './plugins/enrichment/FunctionCallResolver.js';
 export { RustFFIEnricher } from './plugins/enrichment/RustFFIEnricher.js';
+export { NodejsBuiltinsResolver } from './plugins/enrichment/NodejsBuiltinsResolver.js';
+export { ExternalCallResolver } from './plugins/enrichment/ExternalCallResolver.js';
+export { ClosureCaptureEnricher } from './plugins/enrichment/ClosureCaptureEnricher.js';
+export { BuiltinRegistry } from './data/builtins/index.js';
+export type { BuiltinFunctionDef, BuiltinModuleDef, SecurityCategory } from './data/builtins/index.js';
+export { GlobalsRegistry, ALL_GLOBALS } from './data/globals/index.js';
 export { CallResolverValidator } from './plugins/validation/CallResolverValidator.js';
 export { EvalBanValidator } from './plugins/validation/EvalBanValidator.js';
 export { SQLInjectionValidator } from './plugins/validation/SQLInjectionValidator.js';
@@ -50,8 +107,23 @@ export { ShadowingDetector } from './plugins/validation/ShadowingDetector.js';
 export { GraphConnectivityValidator } from './plugins/validation/GraphConnectivityValidator.js';
 export { DataFlowValidator } from './plugins/validation/DataFlowValidator.js';
 export { TypeScriptDeadCodeValidator } from './plugins/validation/TypeScriptDeadCodeValidator.js';
+export { NodeCreationValidator } from './plugins/validation/NodeCreationValidator.js';
+export { BrokenImportValidator } from './plugins/validation/BrokenImportValidator.js';
 export { SimpleProjectDiscovery } from './plugins/discovery/SimpleProjectDiscovery.js';
 export { DiscoveryPlugin } from './plugins/discovery/DiscoveryPlugin.js';
 export { MonorepoServiceDiscovery } from './plugins/discovery/MonorepoServiceDiscovery.js';
+export { WorkspaceDiscovery } from './plugins/discovery/WorkspaceDiscovery.js';
+export { resolveSourceEntrypoint } from './plugins/discovery/resolveSourceEntrypoint.js';
+export type { PackageJsonForResolution } from './plugins/discovery/resolveSourceEntrypoint.js';
+export { detectWorkspaceType, parsePnpmWorkspace, parseNpmWorkspace, parseLernaConfig, resolveWorkspacePackages } from './plugins/discovery/workspaces/index.js';
+export type { WorkspaceType, WorkspaceDetectionResult, WorkspaceConfig, WorkspacePackage } from './plugins/discovery/workspaces/index.js';
+export { GitPlugin } from './plugins/vcs/GitPlugin.js';
+export { VCSPlugin, VCSPluginFactory, FileStatus } from './plugins/vcs/VCSPlugin.js';
+export type { VCSConfig, VCSPluginMetadata, ChangedFile, FileDiff, DiffHunk, } from './plugins/vcs/VCSPlugin.js';
+export type { CommitInfo } from './plugins/vcs/GitPlugin.js';
+export { InterfaceSchemaExtractor, GraphSchemaExtractor } from './schema/index.js';
+export type { InterfaceSchema, PropertySchema, ExtractOptions, GraphSchema, NodeTypeSchema, EdgeTypeSchema, GraphExtractOptions, } from './schema/index.js';
+export { findCallsInFunction, findContainingFunction, traceValues, aggregateValues, NONDETERMINISTIC_PATTERNS, NONDETERMINISTIC_OBJECTS } from './queries/index.js';
+export type { CallInfo, CallerInfo, FindCallsOptions, TracedValue, ValueSource, UnknownReason, TraceValuesOptions, ValueSetResult, TraceValuesGraphBackend, NondeterministicPattern, } from './queries/index.js';
 export type * from '@grafema/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,6 +1,14 @@
 /**
  * @grafema/core - Core analysis engine for GraphDD
  */
+// Error types
+export { GrafemaError, ConfigError, FileAccessError, LanguageError, DatabaseError, PluginError, AnalysisError, ValidationError, StrictModeError, } from './errors/GrafemaError.js';
+// Logging
+export { ConsoleLogger, createLogger } from './logging/Logger.js';
+// Diagnostics
+export { DiagnosticCollector, DiagnosticReporter, DiagnosticWriter } from './diagnostics/index.js';
+// Config
+export { loadConfig, DEFAULT_CONFIG } from './config/index.js';
 // Main orchestrator
 export { Orchestrator } from './Orchestrator.js';
 // Plugin base
@@ -13,22 +21,61 @@ export { RFDBServerBackend } from './storage/backends/RFDBServerBackend.js';
 // Core utilities
 export { NodeFactory } from './core/NodeFactory.js';
 export { Profiler } from './core/Profiler.js';
+export { computeSemanticId, parseSemanticId, computeDiscriminator } from './core/SemanticId.js';
+export { ScopeTracker } from './core/ScopeTracker.js';
 export { AnalysisQueue } from './core/AnalysisQueue.js';
+export { ASTWorkerPool } from './core/ASTWorkerPool.js';
 export { GuaranteeManager } from './core/GuaranteeManager.js';
+export { clearFileNodesIfNeeded, clearServiceNodeIfExists } from './core/FileNodeManager.js';
+export { CoverageAnalyzer } from './core/CoverageAnalyzer.js';
+export { FileExplainer } from './core/FileExplainer.js';
+// Hash utilities
+export { calculateFileHash, calculateFileHashAsync, calculateContentHash } from './core/HashUtils.js';
+// Type validation and path validation
+export { levenshtein, checkTypoAgainstKnownTypes, resetKnownNodeTypes, getKnownNodeTypes } from './storage/backends/typeValidation.js';
+export { PathValidator } from './validation/PathValidator.js';
+// Version management
+export { VersionManager, versionManager } from './core/VersionManager.js';
+// Freshness checking and incremental reanalysis
+export { GraphFreshnessChecker } from './core/GraphFreshnessChecker.js';
+export { IncrementalReanalyzer } from './core/IncrementalReanalyzer.js';
 // API
 export { GraphAPI } from './api/GraphAPI.js';
 export { GuaranteeAPI } from './api/GuaranteeAPI.js';
 // Node kinds
 export { isGuaranteeType } from './core/nodes/NodeKind.js';
+// Issue nodes (detected problems)
+export { IssueNode } from './core/nodes/IssueNode.js';
+// Node contracts
+export { FunctionNode } from './core/nodes/FunctionNode.js';
+export { CallSiteNode } from './core/nodes/CallSiteNode.js';
+export { MethodCallNode } from './core/nodes/MethodCallNode.js';
+export { ScopeNode } from './core/nodes/ScopeNode.js';
+export { ClassNode } from './core/nodes/ClassNode.js';
+export { MethodNode } from './core/nodes/MethodNode.js';
+export { ExportNode } from './core/nodes/ExportNode.js';
+export { VariableDeclarationNode } from './core/nodes/VariableDeclarationNode.js';
+export { ExternalModuleNode } from './core/nodes/ExternalModuleNode.js';
+export { NetworkRequestNode } from './core/nodes/NetworkRequestNode.js';
+export { InterfaceNode } from './core/nodes/InterfaceNode.js';
+export { TypeNode } from './core/nodes/TypeNode.js';
+export { EnumNode } from './core/nodes/EnumNode.js';
+export { DecoratorNode } from './core/nodes/DecoratorNode.js';
+export { ExpressionNode } from './core/nodes/ExpressionNode.js';
+export { ArgumentExpressionNode } from './core/nodes/ArgumentExpressionNode.js';
+// AST Visitors (for advanced usage)
+export { ASTVisitor, ImportExportVisitor, VariableVisitor, FunctionVisitor, ClassVisitor, CallExpressionVisitor, TypeScriptVisitor } from './plugins/analysis/ast/visitors/index.js';
+// AST Location utilities (REG-122)
+export { getNodeLocation, getLine, getColumn, getEndLocation, UNKNOWN_LOCATION } from './plugins/analysis/ast/utils/location.js';
 // === PLUGINS ===
 // Indexing plugins
 export { JSModuleIndexer } from './plugins/indexing/JSModuleIndexer.js';
 export { IncrementalModuleIndexer } from './plugins/indexing/IncrementalModuleIndexer.js';
 export { RustModuleIndexer } from './plugins/indexing/RustModuleIndexer.js';
-export { ServiceDetector } from './plugins/indexing/ServiceDetector.js';
 // Analysis plugins
 export { JSASTAnalyzer } from './plugins/analysis/JSASTAnalyzer.js';
 export { ExpressRouteAnalyzer } from './plugins/analysis/ExpressRouteAnalyzer.js';
+export { ExpressResponseAnalyzer } from './plugins/analysis/ExpressResponseAnalyzer.js';
 export { ExpressAnalyzer } from './plugins/analysis/ExpressAnalyzer.js';
 export { SocketIOAnalyzer } from './plugins/analysis/SocketIOAnalyzer.js';
 export { DatabaseAnalyzer } from './plugins/analysis/DatabaseAnalyzer.js';
@@ -41,6 +88,7 @@ export { SystemDbAnalyzer } from './plugins/analysis/SystemDbAnalyzer.js';
 export { IncrementalAnalysisPlugin } from './plugins/analysis/IncrementalAnalysisPlugin.js';
 // Enrichment plugins
 export { MethodCallResolver } from './plugins/enrichment/MethodCallResolver.js';
+export { ArgumentParameterLinker } from './plugins/enrichment/ArgumentParameterLinker.js';
 export { AliasTracker } from './plugins/enrichment/AliasTracker.js';
 export { ValueDomainAnalyzer } from './plugins/enrichment/ValueDomainAnalyzer.js';
 export { MountPointResolver } from './plugins/enrichment/MountPointResolver.js';
@@ -48,7 +96,15 @@ export { PrefixEvaluator } from './plugins/enrichment/PrefixEvaluator.js';
 export { InstanceOfResolver } from './plugins/enrichment/InstanceOfResolver.js';
 export { HTTPConnectionEnricher } from './plugins/enrichment/HTTPConnectionEnricher.js';
 export { ImportExportLinker } from './plugins/enrichment/ImportExportLinker.js';
+export { FunctionCallResolver } from './plugins/enrichment/FunctionCallResolver.js';
 export { RustFFIEnricher } from './plugins/enrichment/RustFFIEnricher.js';
+export { NodejsBuiltinsResolver } from './plugins/enrichment/NodejsBuiltinsResolver.js';
+export { ExternalCallResolver } from './plugins/enrichment/ExternalCallResolver.js';
+export { ClosureCaptureEnricher } from './plugins/enrichment/ClosureCaptureEnricher.js';
+// Builtin registry
+export { BuiltinRegistry } from './data/builtins/index.js';
+// Globals registry
+export { GlobalsRegistry, ALL_GLOBALS } from './data/globals/index.js';
 // Validation plugins
 export { CallResolverValidator } from './plugins/validation/CallResolverValidator.js';
 export { EvalBanValidator } from './plugins/validation/EvalBanValidator.js';
@@ -57,7 +113,20 @@ export { ShadowingDetector } from './plugins/validation/ShadowingDetector.js';
 export { GraphConnectivityValidator } from './plugins/validation/GraphConnectivityValidator.js';
 export { DataFlowValidator } from './plugins/validation/DataFlowValidator.js';
 export { TypeScriptDeadCodeValidator } from './plugins/validation/TypeScriptDeadCodeValidator.js';
+export { NodeCreationValidator } from './plugins/validation/NodeCreationValidator.js';
+export { BrokenImportValidator } from './plugins/validation/BrokenImportValidator.js';
 // Discovery plugins
 export { SimpleProjectDiscovery } from './plugins/discovery/SimpleProjectDiscovery.js';
 export { DiscoveryPlugin } from './plugins/discovery/DiscoveryPlugin.js';
 export { MonorepoServiceDiscovery } from './plugins/discovery/MonorepoServiceDiscovery.js';
+export { WorkspaceDiscovery } from './plugins/discovery/WorkspaceDiscovery.js';
+export { resolveSourceEntrypoint } from './plugins/discovery/resolveSourceEntrypoint.js';
+// Workspace detection utilities
+export { detectWorkspaceType, parsePnpmWorkspace, parseNpmWorkspace, parseLernaConfig, resolveWorkspacePackages } from './plugins/discovery/workspaces/index.js';
+// VCS plugins
+export { GitPlugin } from './plugins/vcs/GitPlugin.js';
+export { VCSPlugin, VCSPluginFactory, FileStatus } from './plugins/vcs/VCSPlugin.js';
+// Schema extraction
+export { InterfaceSchemaExtractor, GraphSchemaExtractor } from './schema/index.js';
+// Graph Query Utilities
+export { findCallsInFunction, findContainingFunction, traceValues, aggregateValues, NONDETERMINISTIC_PATTERNS, NONDETERMINISTIC_OBJECTS } from './queries/index.js';

package/dist/logging/Logger.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Logger - Lightweight logging for Grafema
+ *
+ * Features:
+ * - 5 log levels: silent, errors, warnings, info, debug
+ * - Context support for structured logging
+ * - No external dependencies
+ * - Safe handling of circular references
+ *
+ * Usage:
+ *   const logger = createLogger('info');
+ *   logger.info('Processing files', { count: 150 });
+ */
+/**
+ * Log level type
+ */
+export type LogLevel = 'silent' | 'errors' | 'warnings' | 'info' | 'debug';
+/**
+ * Logger interface
+ */
+export interface Logger {
+    error(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+    trace(message: string, context?: Record<string, unknown>): void;
+}
+/**
+ * Console-based Logger implementation
+ *
+ * Respects log level threshold - methods below threshold are no-ops.
+ */
+export declare class ConsoleLogger implements Logger {
+    private readonly level;
+    private readonly priority;
+    constructor(logLevel?: LogLevel);
+    private shouldLog;
+    error(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+    trace(message: string, context?: Record<string, unknown>): void;
+}
+/**
+ * Create a Logger instance with the specified log level
+ */
+export declare function createLogger(level: LogLevel): Logger;
+//# sourceMappingURL=Logger.d.ts.map

package/dist/logging/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/logging/Logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAChE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CACjE;AAsDD;;;;GAIG;AACH,qBAAa,aAAc,YAAW,MAAM;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,QAAQ,GAAE,QAAiB;IAKvC,OAAO,CAAC,SAAS;IAIjB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAS/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAS9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAS9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAS/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAQhE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAEpD"}

package/dist/logging/Logger.js

@@ -0,0 +1,134 @@
+/**
+ * Logger - Lightweight logging for Grafema
+ *
+ * Features:
+ * - 5 log levels: silent, errors, warnings, info, debug
+ * - Context support for structured logging
+ * - No external dependencies
+ * - Safe handling of circular references
+ *
+ * Usage:
+ *   const logger = createLogger('info');
+ *   logger.info('Processing files', { count: 150 });
+ */
+/**
+ * Log level priorities (higher = more verbose)
+ */
+const LOG_LEVEL_PRIORITY = {
+    silent: 0,
+    errors: 1,
+    warnings: 2,
+    info: 3,
+    debug: 4,
+};
+/**
+ * Minimum level required for each method
+ */
+const METHOD_LEVELS = {
+    error: LOG_LEVEL_PRIORITY.errors,
+    warn: LOG_LEVEL_PRIORITY.warnings,
+    info: LOG_LEVEL_PRIORITY.info,
+    debug: LOG_LEVEL_PRIORITY.debug,
+    trace: LOG_LEVEL_PRIORITY.debug,
+};
+/**
+ * Safe JSON stringify that handles circular references
+ */
+function safeStringify(obj) {
+    const seen = new WeakSet();
+    return JSON.stringify(obj, (_key, value) => {
+        if (typeof value === 'object' && value !== null) {
+            if (seen.has(value)) {
+                return '[Circular]';
+            }
+            seen.add(value);
+        }
+        return value;
+    });
+}
+/**
+ * Format log message with optional context
+ */
+function formatMessage(message, context) {
+    if (!context || Object.keys(context).length === 0) {
+        return message;
+    }
+    try {
+        return `${message} ${safeStringify(context)}`;
+    }
+    catch {
+        return `${message} [context serialization failed]`;
+    }
+}
+/**
+ * Console-based Logger implementation
+ *
+ * Respects log level threshold - methods below threshold are no-ops.
+ */
+export class ConsoleLogger {
+    level;
+    priority;
+    constructor(logLevel = 'info') {
+        this.level = logLevel;
+        this.priority = LOG_LEVEL_PRIORITY[logLevel];
+    }
+    shouldLog(methodLevel) {
+        return this.priority >= methodLevel;
+    }
+    error(message, context) {
+        if (!this.shouldLog(METHOD_LEVELS.error))
+            return;
+        try {
+            console.error(formatMessage(`[ERROR] ${message}`, context));
+        }
+        catch {
+            console.log(`[ERROR] ${message} [logging failed]`);
+        }
+    }
+    warn(message, context) {
+        if (!this.shouldLog(METHOD_LEVELS.warn))
+            return;
+        try {
+            console.warn(formatMessage(`[WARN] ${message}`, context));
+        }
+        catch {
+            console.log(`[WARN] ${message} [logging failed]`);
+        }
+    }
+    info(message, context) {
+        if (!this.shouldLog(METHOD_LEVELS.info))
+            return;
+        try {
+            console.info(formatMessage(`[INFO] ${message}`, context));
+        }
+        catch {
+            console.log(`[INFO] ${message} [logging failed]`);
+        }
+    }
+    debug(message, context) {
+        if (!this.shouldLog(METHOD_LEVELS.debug))
+            return;
+        try {
+            console.debug(formatMessage(`[DEBUG] ${message}`, context));
+        }
+        catch {
+            console.log(`[DEBUG] ${message} [logging failed]`);
+        }
+    }
+    trace(message, context) {
+        if (!this.shouldLog(METHOD_LEVELS.trace))
+            return;
+        try {
+            console.debug(formatMessage(`[TRACE] ${message}`, context));
+        }
+        catch {
+            console.log(`[TRACE] ${message} [logging failed]`);
+        }
+    }
+}
+/**
+ * Create a Logger instance with the specified log level
+ */
+export function createLogger(level) {
+    return new ConsoleLogger(level);
+}

package/dist/plugins/Plugin.d.ts

@@ -7,7 +7,7 @@
  * 2. Execute - plugin logic execution
  * 3. Return value - PluginResult
  */
-import type { PluginMetadata, PluginContext, PluginResult, IPlugin } from '@grafema/types';
+import type { PluginMetadata, PluginContext, PluginResult, IPlugin, Logger } from '@grafema/types';
 import type { NodeRecord } from '@grafema/types';
 export type { PluginMetadata, PluginContext, PluginResult, IPlugin };
 export { createSuccessResult, createErrorResult } from '@grafema/types';
@@ -40,5 +40,9 @@ export declare abstract class Plugin implements IPlugin {
      * Works with RFDBServerBackend
      */
     getModules(graph: PluginContext['graph']): Promise<NodeRecord[]>;
+    /**
+     * Get a logger from context with console fallback for backward compatibility.
+     */
+    protected log(context: PluginContext): Logger;
 }
 //# sourceMappingURL=Plugin.d.ts.map