@grafema/core 0.2.5-beta → 0.2.7

package/README.md

@@ -2,7 +2,7 @@
 
 > Core analysis engine for Grafema code analysis toolkit
 
-**Warning: This package is in early alpha stage and is not recommended for production use.**
+**Warning: This package is in beta stage and the API may change between minor versions.**
 
 ## Installation
 
@@ -14,10 +14,10 @@ npm install @grafema/core
 
 The core analysis engine that powers Grafema. It provides:
 
-- **Orchestrator** - 5-phase analysis pipeline with parallel processing
-- **Plugin system** - Extensible architecture for custom analyzers
-- **Graph backend** - Abstract interface for graph storage
-- **Built-in plugins** - Ready-to-use analyzers for JS/TS, React, Express, and more
+- **Orchestrator** — 5-phase analysis pipeline with parallel processing
+- **Plugin system** — Extensible architecture with declarative dependencies and topological ordering
+- **Graph backend** — Abstract interface for graph storage (RFDB or in-memory)
+- **33 built-in plugins** — Ready-to-use analyzers for JS/TS, React, Express, and more
 
 ## Quick Start
 
@@ -41,34 +41,72 @@ console.log(`Analyzed ${stats.filesProcessed} files`);
 
 The orchestrator runs analysis in 5 phases:
 
-1. **Discovery** - Find project structure and entry points
-2. **Indexing** - Build module dependency graph
-3. **Analysis** - Parse AST and extract entities
-4. **Enrichment** - Resolve references and add edges
-5. **Validation** - Check invariants and detect issues
+1. **Discovery** — Find project structure, workspaces, and entry points
+2. **Indexing** — Build module dependency graph
+3. **Analysis** — Parse AST and extract entities (parallel across files)
+4. **Enrichment** — Resolve cross-file references and add edges
+5. **Validation** — Check invariants and detect issues
 
 ## Built-in Plugins
 
+### Discovery
+- `WorkspaceDiscovery` — npm/pnpm/yarn/lerna workspace detection
+- `MonorepoServiceDiscovery` — Monorepo service discovery
+
 ### Indexing
-- `JSModuleIndexer` - JavaScript/TypeScript module resolution
-- `RustModuleIndexer` - Rust crate analysis
+- `JSModuleIndexer` — JavaScript/TypeScript module resolution
+- `RustModuleIndexer` — Rust crate analysis
 
 ### Analysis
-- `JSASTAnalyzer` - Core JS/TS AST analysis
-- `ExpressAnalyzer` - Express.js routes and middleware
-- `ReactAnalyzer` - React components and hooks
-- `DatabaseAnalyzer` - SQL query detection
-- `SocketIOAnalyzer` - WebSocket event handlers
+- `JSASTAnalyzer` — Core JS/TS AST analysis
+- `ExpressRouteAnalyzer` — Express.js routes and middleware
+- `ExpressResponseAnalyzer` — Express.js response tracking
+- `NestJSRouteAnalyzer` — NestJS controller routes
+- `ReactAnalyzer` — React components and hooks
+- `DatabaseAnalyzer` — SQL query detection
+- `FetchAnalyzer` — HTTP fetch/axios call tracking
+- `SocketIOAnalyzer` — WebSocket event handlers
+- `ServiceLayerAnalyzer` — Service layer pattern detection
 
 ### Enrichment
-- `AliasTracker` - Transitive alias resolution
-- `MethodCallResolver` - Method call binding
-- `ValueDomainAnalyzer` - Value set analysis
+- `MethodCallResolver` — Method call binding
+- `ArgumentParameterLinker` — Argument-to-parameter binding
+- `AliasTracker` — Transitive alias resolution
+- `ImportExportLinker` — Cross-file import resolution
+- `ValueDomainAnalyzer` — Value set analysis
+- `MountPointResolver` — Express router mount prefix resolution
+- `ClosureCaptureEnricher` — Closure variable capture
+- `ServiceConnectionEnricher` — Cross-service connection discovery
 
 ### Validation
-- `EvalBanValidator` - Detect dangerous eval usage
-- `SQLInjectionValidator` - SQL injection detection
-- `CallResolverValidator` - Unresolved call detection
+- `EvalBanValidator` — Detect dangerous eval usage
+- `SQLInjectionValidator` — SQL injection detection
+- `CallResolverValidator` — Unresolved call detection
+- `BrokenImportValidator` — Broken import detection
+- `PackageCoverageValidator` — npm package analyzer coverage tracking
+- `ShadowingDetector` — Variable shadowing detection
+- `AwaitInLoopValidator` — Await-in-loop performance issues
+
+## Extending
+
+Create custom plugins by implementing the plugin interface:
+
+```typescript
+import { AnalysisPlugin } from '@grafema/core';
+
+class MyPlugin extends AnalysisPlugin {
+  static metadata = {
+    name: 'my-plugin',
+    phase: 'ANALYSIS',
+    creates: ['MY_NODE_TYPE'],
+    dependencies: ['JSASTAnalyzer'],
+  };
+
+  async analyze(file, context) {
+    // Your analysis logic
+  }
+}
+```
 
 ## License
 

package/dist/DiscoveryManager.d.ts

@@ -0,0 +1,59 @@
+/**
+ * DiscoveryManager — handles service and entrypoint discovery.
+ * Extracted from Orchestrator.ts (REG-462).
+ *
+ * Responsibilities:
+ * - Run discovery plugins to find services/entrypoints
+ * - Handle config-provided services (REG-174)
+ * - Handle entrypoint override (bypass discovery)
+ * - Build unified list of indexing units
+ * - Topological sort of discovery plugins (REG-367)
+ */
+import type { Plugin } from './plugins/Plugin.js';
+import type { GraphBackend, Logger, ServiceDefinition } from '@grafema/types';
+import type { ProgressCallback } from './PhaseRunner.js';
+import type { OrchestratorOptions, DiscoveryManifest, IndexingUnit } from './OrchestratorTypes.js';
+export declare class DiscoveryManager {
+    private plugins;
+    private graph;
+    private config;
+    private logger;
+    private onProgress;
+    private configServices;
+    constructor(plugins: Plugin[], graph: GraphBackend, config: OrchestratorOptions, logger: Logger, onProgress: ProgressCallback, configServices: ServiceDefinition[] | undefined);
+    /**
+     * Run discovery: entrypoint override → config services → plugin discovery.
+     * Returns a DiscoveryManifest with discovered services and entrypoints.
+     */
+    discover(projectPath: string, entrypoint?: string): Promise<DiscoveryManifest>;
+    /**
+     * Discover services in a specific root directory.
+     * Used by multi-root workspace analysis (REG-76).
+     */
+    discoverInRoot(rootPath: string): Promise<DiscoveryManifest>;
+    /**
+     * Build unified list of indexing units from services and entrypoints.
+     * Deduplicates by path (services take priority over entrypoints).
+     */
+    buildIndexingUnits(manifest: DiscoveryManifest): IndexingUnit[];
+    /**
+     * Create synthetic manifest from entrypoint override (bypasses discovery).
+     */
+    private discoverFromEntrypoint;
+    /**
+     * Discovery via config services or plugins.
+     * Config services (REG-174) take precedence if provided.
+     */
+    private discoverFromPluginsOrConfig;
+    /**
+     * Use config-provided services directly (REG-174).
+     * Creates SERVICE nodes in graph and returns manifest.
+     */
+    private discoverFromConfig;
+    /**
+     * Run discovery plugins (original code path).
+     * Plugins are topologically sorted by dependencies (REG-367).
+     */
+    private discoverFromPlugins;
+}
+//# sourceMappingURL=DiscoveryManager.d.ts.map

package/dist/DiscoveryManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiscoveryManager.d.ts","sourceRoot":"","sources":["../src/DiscoveryManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAG9E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EACV,mBAAmB,EAGnB,iBAAiB,EACjB,YAAY,EACb,MAAM,wBAAwB,CAAC;AAEhC,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,cAAc;gBALd,OAAO,EAAE,MAAM,EAAE,EACjB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,gBAAgB,EAC5B,cAAc,EAAE,iBAAiB,EAAE,GAAG,SAAS;IAGzD;;;OAGG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAOpF;;;OAGG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIlE;;;OAGG;IACH,kBAAkB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,YAAY,EAAE;IA4C/D;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmB9B;;;OAGG;YACW,2BAA2B;IAOzC;;;OAGG;YACW,kBAAkB;IA8DhC;;;OAGG;YACW,mBAAmB;CAsElC"}

package/dist/DiscoveryManager.js

@@ -0,0 +1,249 @@
+/**
+ * DiscoveryManager — handles service and entrypoint discovery.
+ * Extracted from Orchestrator.ts (REG-462).
+ *
+ * Responsibilities:
+ * - Run discovery plugins to find services/entrypoints
+ * - Handle config-provided services (REG-174)
+ * - Handle entrypoint override (bypass discovery)
+ * - Build unified list of indexing units
+ * - Topological sort of discovery plugins (REG-367)
+ */
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { resolveSourceEntrypoint } from './plugins/discovery/resolveSourceEntrypoint.js';
+import { NodeFactory } from './core/NodeFactory.js';
+import { toposort } from './core/toposort.js';
+export class DiscoveryManager {
+    plugins;
+    graph;
+    config;
+    logger;
+    onProgress;
+    configServices;
+    constructor(plugins, graph, config, logger, onProgress, configServices) {
+        this.plugins = plugins;
+        this.graph = graph;
+        this.config = config;
+        this.logger = logger;
+        this.onProgress = onProgress;
+        this.configServices = configServices;
+    }
+    /**
+     * Run discovery: entrypoint override → config services → plugin discovery.
+     * Returns a DiscoveryManifest with discovered services and entrypoints.
+     */
+    async discover(projectPath, entrypoint) {
+        if (entrypoint) {
+            return this.discoverFromEntrypoint(projectPath, entrypoint);
+        }
+        return this.discoverFromPluginsOrConfig(projectPath);
+    }
+    /**
+     * Discover services in a specific root directory.
+     * Used by multi-root workspace analysis (REG-76).
+     */
+    async discoverInRoot(rootPath) {
+        return this.discoverFromPluginsOrConfig(rootPath);
+    }
+    /**
+     * Build unified list of indexing units from services and entrypoints.
+     * Deduplicates by path (services take priority over entrypoints).
+     */
+    buildIndexingUnits(manifest) {
+        const units = [];
+        const seenPaths = new Set();
+        // 1. Add services first (they have priority)
+        for (const service of manifest.services || []) {
+            const path = service.path || service.metadata?.entrypoint;
+            if (path && !seenPaths.has(path)) {
+                seenPaths.add(path);
+                units.push({
+                    ...service, // Spread first to allow overrides
+                    id: service.id,
+                    name: service.name,
+                    path: path,
+                    type: 'service',
+                });
+            }
+        }
+        // 2. Add entrypoints that aren't already covered by services
+        for (const ep of manifest.entrypoints || []) {
+            const path = ep.file;
+            if (path && !seenPaths.has(path)) {
+                seenPaths.add(path);
+                units.push({
+                    ...ep, // Spread first to allow overrides
+                    id: ep.id,
+                    name: ep.name || ep.file.split('/').pop(),
+                    path: path,
+                    type: 'entrypoint',
+                    entrypointType: ep.type,
+                    trigger: ep.trigger,
+                });
+            }
+        }
+        this.logger.debug('Built indexing units', {
+            total: units.length,
+            services: units.filter(u => u.type === 'service').length,
+            entrypoints: units.filter(u => u.type === 'entrypoint').length
+        });
+        return units;
+    }
+    /**
+     * Create synthetic manifest from entrypoint override (bypasses discovery).
+     */
+    discoverFromEntrypoint(projectPath, entrypoint) {
+        const entrypointPath = entrypoint.startsWith('/')
+            ? entrypoint
+            : join(projectPath, entrypoint);
+        const serviceName = entrypoint.split('/').pop()?.replace(/\.[^.]+$/, '') || 'main';
+        const manifest = {
+            services: [{
+                    id: `service:${serviceName}`,
+                    name: serviceName,
+                    path: entrypointPath,
+                    metadata: { entrypoint: entrypointPath }
+                }],
+            entrypoints: [],
+            projectPath: projectPath
+        };
+        this.logger.info('Using entrypoint override', { entrypoint, resolved: entrypointPath });
+        return manifest;
+    }
+    /**
+     * Discovery via config services or plugins.
+     * Config services (REG-174) take precedence if provided.
+     */
+    async discoverFromPluginsOrConfig(projectPath) {
+        if (this.configServices && this.configServices.length > 0) {
+            return this.discoverFromConfig(projectPath);
+        }
+        return this.discoverFromPlugins(projectPath);
+    }
+    /**
+     * Use config-provided services directly (REG-174).
+     * Creates SERVICE nodes in graph and returns manifest.
+     */
+    async discoverFromConfig(projectPath) {
+        this.logger.info('Using config-provided services (skipping discovery plugins)', {
+            serviceCount: this.configServices.length
+        });
+        const services = [];
+        for (const configSvc of this.configServices) {
+            const servicePath = join(projectPath, configSvc.path);
+            // Resolve entrypoint
+            let entrypoint;
+            if (configSvc.entryPoint) {
+                entrypoint = configSvc.entryPoint;
+            }
+            else {
+                const packageJsonPath = join(servicePath, 'package.json');
+                if (existsSync(packageJsonPath)) {
+                    try {
+                        const pkg = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+                        entrypoint = resolveSourceEntrypoint(servicePath, pkg) ?? pkg.main ?? 'index.js';
+                    }
+                    catch (e) {
+                        const message = e instanceof Error ? e.message : String(e);
+                        this.logger.warn('Failed to read package.json for auto-detection', {
+                            service: configSvc.name,
+                            path: packageJsonPath,
+                            error: message
+                        });
+                        entrypoint = 'index.js';
+                    }
+                }
+                else {
+                    entrypoint = 'index.js';
+                }
+            }
+            const serviceNode = NodeFactory.createService(configSvc.name, servicePath, {
+                discoveryMethod: 'config',
+                entrypoint: entrypoint,
+            });
+            await this.graph.addNode(serviceNode);
+            services.push({
+                id: serviceNode.id,
+                name: configSvc.name,
+                path: servicePath,
+                metadata: {
+                    entrypoint: join(servicePath, entrypoint),
+                },
+            });
+            this.logger.info('Registered config service', {
+                name: configSvc.name,
+                path: servicePath,
+                entrypoint: entrypoint
+            });
+        }
+        return {
+            services,
+            entrypoints: [],
+            projectPath: projectPath
+        };
+    }
+    /**
+     * Run discovery plugins (original code path).
+     * Plugins are topologically sorted by dependencies (REG-367).
+     */
+    async discoverFromPlugins(projectPath) {
+        const context = {
+            projectPath,
+            graph: this.graph,
+            config: this.config,
+            phase: 'DISCOVERY',
+            logger: this.logger,
+        };
+        // Filter plugins for DISCOVERY phase
+        const discoveryPlugins = this.plugins.filter(p => p.metadata.phase === 'DISCOVERY');
+        // Topological sort by dependencies (REG-367)
+        const discoveryPluginMap = new Map(discoveryPlugins.map(p => [p.metadata.name, p]));
+        const sortedDiscoveryIds = toposort(discoveryPlugins.map(p => ({
+            id: p.metadata.name,
+            dependencies: p.metadata.dependencies ?? [],
+        })));
+        discoveryPlugins.length = 0;
+        for (const id of sortedDiscoveryIds) {
+            const plugin = discoveryPluginMap.get(id);
+            if (plugin)
+                discoveryPlugins.push(plugin);
+        }
+        const allServices = [];
+        const allEntrypoints = [];
+        for (let i = 0; i < discoveryPlugins.length; i++) {
+            const plugin = discoveryPlugins[i];
+            this.onProgress({
+                phase: 'discovery',
+                currentPlugin: plugin.metadata.name,
+                message: `Running ${plugin.metadata.name}... (${i + 1}/${discoveryPlugins.length})`
+            });
+            const result = await plugin.execute(context);
+            if (result.success && result.metadata?.services) {
+                allServices.push(...result.metadata.services);
+            }
+            if (result.success && result.metadata?.entrypoints) {
+                allEntrypoints.push(...result.metadata.entrypoints);
+            }
+            if (result.success && result.created.nodes > 0 &&
+                !result.metadata?.services && !result.metadata?.entrypoints) {
+                this.logger.warn('Discovery plugin created nodes but returned no services/entrypoints in metadata', {
+                    plugin: plugin.metadata.name,
+                    nodesCreated: result.created.nodes,
+                    hint: 'Services must be returned via result.metadata.services for Orchestrator to index them'
+                });
+            }
+            this.onProgress({
+                phase: 'discovery',
+                currentPlugin: plugin.metadata.name,
+                message: `✓ ${plugin.metadata.name} complete`
+            });
+        }
+        return {
+            services: allServices,
+            entrypoints: allEntrypoints,
+            projectPath: projectPath
+        };
+    }
+}
+//# sourceMappingURL=DiscoveryManager.js.map

package/dist/DiscoveryManager.js.map

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

package/dist/GraphInitializer.d.ts

@@ -0,0 +1,44 @@
+/**
+ * GraphInitializer — sets up the graph structure before analysis.
+ * Extracted from Orchestrator.ts (REG-462).
+ *
+ * Responsibilities:
+ * - Create GRAPH_META node with project metadata
+ * - Register plugin nodes (grafema:plugin) with dependency edges
+ * - Declare metadata fields for RFDB server-side indexing
+ */
+import type { Plugin } from './plugins/Plugin.js';
+import type { GraphBackend, Logger } from '@grafema/types';
+export declare class GraphInitializer {
+    private graph;
+    private plugins;
+    private logger;
+    constructor(graph: GraphBackend, plugins: Plugin[], logger: Logger);
+    /**
+     * Initialize graph: register plugins, declare fields, create meta node.
+     * Called once at the start of analysis (before any phase).
+     */
+    init(projectPath: string): Promise<void>;
+    /**
+     * Create GRAPH_META node with project metadata.
+     * Called once at the start of analysis (single-root or multi-root).
+     */
+    private createGraphMetaNode;
+    /**
+     * Register all loaded plugins as grafema:plugin nodes in the graph.
+     *
+     * Creates a node for each plugin with its metadata (phase, priority,
+     * creates, dependencies). Also creates DEPENDS_ON edges between
+     * plugins that declare dependencies.
+     *
+     * Complexity: O(p) where p = number of plugins (typically 20-35).
+     */
+    private registerPluginNodes;
+    /**
+     * Collect field declarations from all plugins and send to RFDB for indexing.
+     * Deduplicates by field name (last declaration wins if nodeTypes differ).
+     * Called once before analysis to enable server-side metadata indexing.
+     */
+    private declarePluginFields;
+}
+//# sourceMappingURL=GraphInitializer.d.ts.map

package/dist/GraphInitializer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GraphInitializer.d.ts","sourceRoot":"","sources":["../src/GraphInitializer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAgC,MAAM,gBAAgB,CAAC;AAIzF,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;gBAFN,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,EAAE,EACjB,MAAM,EAAE,MAAM;IAGxB;;;OAGG;IACG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C;;;OAGG;YACW,mBAAmB;IAWjC;;;;;;;;OAQG;YACW,mBAAmB;IAmDjC;;;;OAIG;YACW,mBAAmB;CAkBlC"}

package/dist/GraphInitializer.js

@@ -0,0 +1,121 @@
+/**
+ * GraphInitializer — sets up the graph structure before analysis.
+ * Extracted from Orchestrator.ts (REG-462).
+ *
+ * Responsibilities:
+ * - Create GRAPH_META node with project metadata
+ * - Register plugin nodes (grafema:plugin) with dependency edges
+ * - Declare metadata fields for RFDB server-side indexing
+ */
+import { NodeFactory } from './core/NodeFactory.js';
+import { brandNodeInternal } from './core/brandNodeInternal.js';
+export class GraphInitializer {
+    graph;
+    plugins;
+    logger;
+    constructor(graph, plugins, logger) {
+        this.graph = graph;
+        this.plugins = plugins;
+        this.logger = logger;
+    }
+    /**
+     * Initialize graph: register plugins, declare fields, create meta node.
+     * Called once at the start of analysis (before any phase).
+     */
+    async init(projectPath) {
+        await this.registerPluginNodes();
+        await this.declarePluginFields();
+        await this.createGraphMetaNode(projectPath);
+    }
+    /**
+     * Create GRAPH_META node with project metadata.
+     * Called once at the start of analysis (single-root or multi-root).
+     */
+    async createGraphMetaNode(projectPath) {
+        await this.graph.addNode(brandNodeInternal({
+            id: '__graph_meta__',
+            type: 'GRAPH_META',
+            name: 'graph_metadata',
+            file: '',
+            projectPath: projectPath,
+            analyzedAt: new Date().toISOString()
+        }));
+    }
+    /**
+     * Register all loaded plugins as grafema:plugin nodes in the graph.
+     *
+     * Creates a node for each plugin with its metadata (phase, priority,
+     * creates, dependencies). Also creates DEPENDS_ON edges between
+     * plugins that declare dependencies.
+     *
+     * Complexity: O(p) where p = number of plugins (typically 20-35).
+     */
+    async registerPluginNodes() {
+        const pluginNodes = [];
+        for (const plugin of this.plugins) {
+            const meta = plugin.metadata;
+            if (!meta?.name)
+                continue;
+            const sourceFile = plugin.config?.sourceFile || '';
+            const isBuiltin = !sourceFile;
+            const node = NodeFactory.createPlugin(meta.name, meta.phase, {
+                file: sourceFile,
+                builtin: isBuiltin,
+                createsNodes: meta.creates?.nodes ?? [],
+                createsEdges: meta.creates?.edges ?? [],
+                dependencies: meta.dependencies ?? [],
+            });
+            await this.graph.addNode(node);
+            pluginNodes.push({
+                id: node.id,
+                name: meta.name,
+                dependencies: meta.dependencies ?? [],
+            });
+        }
+        // Create DEPENDS_ON edges between plugins
+        const nameToId = new Map();
+        for (const pn of pluginNodes) {
+            nameToId.set(pn.name, pn.id);
+        }
+        for (const pn of pluginNodes) {
+            for (const dep of pn.dependencies) {
+                const depId = nameToId.get(dep);
+                if (depId) {
+                    await this.graph.addEdge({
+                        src: pn.id,
+                        dst: depId,
+                        type: 'DEPENDS_ON',
+                    });
+                }
+            }
+        }
+        this.logger.debug('Registered plugin nodes', {
+            count: pluginNodes.length,
+            edges: pluginNodes.reduce((sum, pn) => sum + pn.dependencies.filter(d => nameToId.has(d)).length, 0),
+        });
+    }
+    /**
+     * Collect field declarations from all plugins and send to RFDB for indexing.
+     * Deduplicates by field name (last declaration wins if nodeTypes differ).
+     * Called once before analysis to enable server-side metadata indexing.
+     */
+    async declarePluginFields() {
+        if (!this.graph.declareFields)
+            return;
+        const fieldMap = new Map();
+        for (const plugin of this.plugins) {
+            const fields = plugin.metadata?.fields;
+            if (!fields)
+                continue;
+            for (const field of fields) {
+                fieldMap.set(field.name, field);
+            }
+        }
+        if (fieldMap.size === 0)
+            return;
+        const fields = [...fieldMap.values()];
+        const count = await this.graph.declareFields(fields);
+        this.logger.debug('Declared metadata fields for indexing', { fields: count });
+    }
+}
+//# sourceMappingURL=GraphInitializer.js.map

package/dist/GraphInitializer.js.map

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

package/dist/GuaranteeChecker.d.ts

@@ -0,0 +1,35 @@
+/**
+ * GuaranteeChecker — runs guarantee checks after enrichment, before validation.
+ * Extracted from Orchestrator.ts (REG-462).
+ *
+ * Responsibilities:
+ * - Load and execute guarantees via GuaranteeManager (RFD-18)
+ * - Selective vs full checking based on enrichment delta
+ * - Collect violations into diagnostics
+ * - Coverage monitoring canary
+ */
+import type { GraphBackend, Logger } from '@grafema/types';
+import type { DiagnosticCollector } from './diagnostics/DiagnosticCollector.js';
+import type { Profiler } from './core/Profiler.js';
+import type { ProgressCallback } from './PhaseRunner.js';
+export declare class GuaranteeChecker {
+    private graph;
+    private diagnosticCollector;
+    private profiler;
+    private onProgress;
+    private logger;
+    constructor(graph: GraphBackend, diagnosticCollector: DiagnosticCollector, profiler: Profiler, onProgress: ProgressCallback, logger: Logger);
+    /**
+     * Run guarantee checks after enrichment (RFD-18).
+     * Uses selective checking when enrichment produced type changes,
+     * falls back to checkAll when no type info is available.
+     */
+    check(changedTypes: Set<string>, projectPath: string): Promise<void>;
+    /**
+     * Coverage monitoring canary (RFD-18).
+     * Logs a warning if enrichment produced no type changes at all,
+     * which may indicate a coverage gap.
+     */
+    private checkCoverageGaps;
+}
+//# sourceMappingURL=GuaranteeChecker.d.ts.map

package/dist/GuaranteeChecker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GuaranteeChecker.d.ts","sourceRoot":"","sources":["../src/GuaranteeChecker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,MAAM;gBAJN,KAAK,EAAE,YAAY,EACnB,mBAAmB,EAAE,mBAAmB,EACxC,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,MAAM;IAGxB;;;;OAIG;IACG,KAAK,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiD1E;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;CAK1B"}