@grafema/core 0.2.5-beta → 0.2.7

package/dist/PhaseRunner.js

@@ -0,0 +1,332 @@
+/**
+ * PhaseRunner - Executes plugin phases with toposort ordering
+ *
+ * Extracted from Orchestrator.ts (RFD-16, STEP 2.5) to keep
+ * Orchestrator as coordinator, PhaseRunner as executor.
+ *
+ * RFD-17: Enrichment dependency propagation — when an enricher's delta
+ * has changedEdgeTypes, downstream enrichers consuming those types are
+ * enqueued and re-run. Queue respects topological order, each enricher
+ * runs at most once.
+ */
+import { NodeFactory } from './core/NodeFactory.js';
+import { toposort } from './core/toposort.js';
+import { buildDependencyGraph } from './core/buildDependencyGraph.js';
+export class PhaseRunner {
+    deps;
+    suppressedByIgnoreCount = 0;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    getSuppressedByIgnoreCount() {
+        return this.suppressedByIgnoreCount;
+    }
+    resetSuppressedByIgnoreCount() {
+        this.suppressedByIgnoreCount = 0;
+    }
+    /**
+     * Execute a plugin wrapped in a CommitBatch.
+     * If the backend doesn't support batching, falls back to direct execution.
+     * Returns the PluginResult and an optional CommitDelta.
+     */
+    async runPluginWithBatch(plugin, pluginContext, phaseName) {
+        const graph = pluginContext.graph;
+        // Fallback: backend doesn't support batching
+        if (!graph.beginBatch || !graph.commitBatch || !graph.abortBatch) {
+            const result = await plugin.execute(pluginContext);
+            return { result, delta: null };
+        }
+        const tags = [plugin.metadata.name, phaseName];
+        // File tags from manifest path (available in ANALYSIS, not ENRICHMENT)
+        const manifest = pluginContext.manifest;
+        if (manifest?.path)
+            tags.push(manifest.path);
+        graph.beginBatch();
+        try {
+            const result = await plugin.execute(pluginContext);
+            const delta = await graph.commitBatch(tags);
+            return { result, delta };
+        }
+        catch (error) {
+            graph.abortBatch();
+            throw error;
+        }
+    }
+    /**
+     * Build a complete PluginContext from partial context + injected deps.
+     * Extracted from runPhase() (RFD-17, STEP 2.5) for reuse in propagation path.
+     */
+    buildPluginContext(baseContext, phaseName, plugin) {
+        const { onProgress, forceAnalysis, logger, strictMode, resourceRegistry, configServices, routing } = this.deps;
+        const pluginContext = {
+            ...baseContext,
+            onProgress: onProgress,
+            forceAnalysis: forceAnalysis,
+            logger: logger,
+            strictMode: strictMode, // REG-330: Pass strict mode flag
+            // REG-76: Pass rootPrefix for multi-root workspace support
+            rootPrefix: baseContext.rootPrefix,
+            // REG-256: Pass resource registry for inter-plugin communication
+            resources: resourceRegistry,
+        };
+        // REG-256: Ensure config is available with routing and services for all plugins
+        if (!pluginContext.config) {
+            pluginContext.config = {
+                projectPath: baseContext.manifest?.projectPath ?? '',
+                services: configServices,
+                routing: routing,
+            };
+        }
+        else {
+            // Merge routing and services into existing config
+            const cfg = pluginContext.config;
+            if (routing && !cfg.routing) {
+                cfg.routing = routing;
+            }
+            if (configServices && !cfg.services) {
+                cfg.services = configServices;
+            }
+        }
+        // Add reportIssue for VALIDATION phase
+        if (phaseName === 'VALIDATION') {
+            pluginContext.reportIssue = async (issue) => {
+                const node = NodeFactory.createIssue(issue.category, issue.severity, issue.message, plugin.metadata.name, issue.file, issue.line, issue.column || 0, { context: issue.context });
+                await baseContext.graph.addNode(node);
+                if (issue.targetNodeId) {
+                    await baseContext.graph.addEdge({
+                        src: node.id,
+                        dst: issue.targetNodeId,
+                        type: 'AFFECTS',
+                    });
+                }
+                return node.id;
+            };
+        }
+        return pluginContext;
+    }
+    /**
+     * Check whether an enricher should be skipped based on selective enrichment.
+     * Returns true if the enricher's consumed types have no overlap with accumulated types
+     * (i.e., no upstream enricher produced anything this one needs).
+     * Level-0 enrichers (consumes: []) are never skipped.
+     */
+    shouldSkipEnricher(plugin, accumulatedTypes) {
+        const consumes = plugin.metadata.consumes ?? [];
+        const isLevel0 = consumes.length === 0;
+        if (isLevel0)
+            return false;
+        return !consumes.some(t => accumulatedTypes.has(t));
+    }
+    /**
+     * Execute a plugin, collect diagnostics, and check for fatal errors.
+     * Shared between the fallback loop and the propagation path.
+     * Returns the delta from the batch commit (if any).
+     */
+    async executePlugin(plugin, context, phaseName) {
+        const { logger, strictMode, diagnosticCollector } = this.deps;
+        const pluginName = plugin.metadata.name;
+        const pluginContext = this.buildPluginContext(context, phaseName, plugin);
+        try {
+            const { result, delta } = await this.runPluginWithBatch(plugin, pluginContext, phaseName);
+            // Log batch delta
+            if (delta) {
+                logger.debug(`[${pluginName}] batch: +${delta.nodesAdded} nodes, +${delta.edgesAdded} edges, ` +
+                    `-${delta.nodesRemoved} nodes, -${delta.edgesRemoved} edges`);
+            }
+            // Collect errors into diagnostics
+            diagnosticCollector.addFromPluginResult(phaseName, pluginName, result);
+            // REG-357: Collect suppressedByIgnore from ENRICHMENT plugin results
+            if (phaseName === 'ENRICHMENT' && result.metadata) {
+                const suppressed = result.metadata.suppressedByIgnore;
+                if (typeof suppressed === 'number') {
+                    this.suppressedByIgnoreCount += suppressed;
+                }
+            }
+            // Log plugin completion with warning if errors occurred
+            if (!result.success) {
+                console.warn(`[Orchestrator] Plugin ${pluginName} reported failure`, {
+                    errors: result.errors.length,
+                    warnings: result.warnings.length,
+                });
+            }
+            // Check for fatal errors - STOP immediately
+            // REG-357: In strict mode ENRICHMENT, don't halt on strict mode errors.
+            // The strict mode barrier after ENRICHMENT handles them collectively.
+            if (diagnosticCollector.hasFatal()) {
+                const allDiagnostics = diagnosticCollector.getAll();
+                const fatals = allDiagnostics.filter(d => d.severity === 'fatal');
+                // Skip halt only if ALL fatals are strict mode errors during ENRICHMENT.
+                // If any non-strict fatal exists, halt immediately.
+                const allStrictErrors = fatals.every(d => d.code.startsWith('STRICT_'));
+                if (!(strictMode && phaseName === 'ENRICHMENT' && allStrictErrors)) {
+                    const fatal = fatals[0];
+                    throw new Error(`Fatal error in ${pluginName}: ${fatal?.message || 'Unknown fatal error'}`);
+                }
+            }
+            return delta;
+        }
+        catch (e) {
+            // Plugin threw an exception (not just returned errors)
+            const error = e instanceof Error ? e : new Error(String(e));
+            // Don't re-add if this was already a fatal error we threw
+            if (!diagnosticCollector.hasFatal()) {
+                diagnosticCollector.add({
+                    code: 'ERR_PLUGIN_THREW',
+                    severity: 'fatal',
+                    message: error.message,
+                    phase: phaseName,
+                    plugin: pluginName,
+                });
+            }
+            throw error; // Re-throw to stop analysis
+        }
+    }
+    async runPhase(phaseName, context) {
+        const { plugins, onProgress, logger } = this.deps;
+        // Filter plugins for this phase
+        const phasePlugins = plugins.filter(plugin => plugin.metadata.phase === phaseName);
+        // Topological sort by dependencies (REG-367, RFD-2)
+        const pluginMap = new Map(phasePlugins.map(p => [p.metadata.name, p]));
+        // Build dependency graph for ENRICHMENT (includes consumer index for RFD-17),
+        // or simple dependency list for other phases.
+        let consumerIndex = null;
+        const sortedIds = (() => {
+            if (phaseName === 'ENRICHMENT') {
+                const depInfo = buildDependencyGraph(phasePlugins);
+                consumerIndex = depInfo.consumerIndex;
+                return toposort(depInfo.items);
+            }
+            return toposort(phasePlugins.map(p => ({
+                id: p.metadata.name,
+                dependencies: p.metadata.dependencies ?? [],
+            })));
+        })();
+        phasePlugins.length = 0;
+        for (const id of sortedIds) {
+            const plugin = pluginMap.get(id);
+            if (plugin)
+                phasePlugins.push(plugin);
+        }
+        // Delta-driven selective enrichment (RFD-16 Phase 3)
+        const supportsBatch = !!(context.graph.beginBatch && context.graph.commitBatch);
+        // RFD-17: Use queue-based propagation for ENRICHMENT with batch support
+        if (phaseName === 'ENRICHMENT' && supportsBatch && consumerIndex) {
+            await this.runEnrichmentWithPropagation(phasePlugins, pluginMap, sortedIds, consumerIndex, context);
+            return new Set();
+        }
+        // Track accumulated changed types for ENRICHMENT skip optimization (fallback path)
+        const accumulatedTypes = new Set();
+        // Execute plugins sequentially (non-ENRICHMENT phases or non-batch backends)
+        for (let i = 0; i < phasePlugins.length; i++) {
+            const plugin = phasePlugins[i];
+            // Selective enrichment: skip enrichers whose consumed types didn't change
+            if (phaseName === 'ENRICHMENT' && supportsBatch) {
+                if (this.shouldSkipEnricher(plugin, accumulatedTypes)) {
+                    logger.debug(`[SKIP] ${plugin.metadata.name} — no changes in consumed types [${(plugin.metadata.consumes ?? []).join(', ')}]`);
+                    continue;
+                }
+            }
+            onProgress({
+                phase: phaseName.toLowerCase(),
+                currentPlugin: plugin.metadata.name,
+                message: `Running plugin ${i + 1}/${phasePlugins.length}: ${plugin.metadata.name}`
+            });
+            const delta = await this.executePlugin(plugin, context, phaseName);
+            // Accumulate changed types for downstream enricher skip checks
+            if (delta) {
+                for (const t of delta.changedNodeTypes)
+                    accumulatedTypes.add(t);
+                for (const t of delta.changedEdgeTypes)
+                    accumulatedTypes.add(t);
+            }
+            // Send completion for this plugin
+            onProgress({
+                phase: phaseName.toLowerCase(),
+                currentPlugin: plugin.metadata.name,
+                message: `✓ ${plugin.metadata.name} complete`
+            });
+        }
+        return accumulatedTypes;
+    }
+    /**
+     * Queue-based enrichment with dependency propagation (RFD-17).
+     *
+     * When an enricher's output changes (delta.changedEdgeTypes non-empty),
+     * downstream enrichers consuming those edge types are enqueued for re-run.
+     * Queue respects topological order. Each enricher runs at most once.
+     * Termination guaranteed by DAG structure + processed-set deduplication.
+     */
+    async runEnrichmentWithPropagation(phasePlugins, pluginMap, sortedIds, consumerIndex, context) {
+        const { onProgress, logger } = this.deps;
+        // Queue state
+        const pending = new Set();
+        const processed = new Set();
+        // Seed: enqueue all level-0 enrichers (they always run)
+        for (const plugin of phasePlugins) {
+            const consumes = plugin.metadata.consumes ?? [];
+            if (consumes.length === 0) {
+                pending.add(plugin.metadata.name);
+            }
+        }
+        // Propagation loop
+        while (pending.size > 0) {
+            const enricherName = this.dequeueNextEnricher(pending, sortedIds);
+            if (!enricherName)
+                break;
+            if (processed.has(enricherName))
+                continue;
+            const plugin = pluginMap.get(enricherName);
+            if (!plugin)
+                continue;
+            onProgress({
+                phase: 'enrichment',
+                currentPlugin: enricherName,
+                message: `Running enricher ${processed.size + 1}/${phasePlugins.length}: ${enricherName}`,
+            });
+            const delta = await this.executePlugin(plugin, context, 'ENRICHMENT');
+            processed.add(enricherName);
+            // Propagate: enqueue downstream enrichers for changed types.
+            // Check both changedEdgeTypes and changedNodeTypes, since consumes
+            // declarations can match either (consistent with RFD-16 accumulation).
+            if (delta) {
+                const changedTypes = [...delta.changedEdgeTypes, ...delta.changedNodeTypes];
+                for (const changedType of changedTypes) {
+                    const consumers = consumerIndex.get(changedType);
+                    if (!consumers)
+                        continue;
+                    for (const consumer of consumers) {
+                        if (!processed.has(consumer)) {
+                            pending.add(consumer);
+                        }
+                    }
+                }
+            }
+            onProgress({
+                phase: 'enrichment',
+                currentPlugin: enricherName,
+                message: `✓ ${enricherName} complete`,
+            });
+        }
+        // Log skipped enrichers (not enqueued because their consumed types never appeared)
+        for (const plugin of phasePlugins) {
+            if (!processed.has(plugin.metadata.name)) {
+                const consumes = plugin.metadata.consumes ?? [];
+                logger.debug(`[SKIP] ${plugin.metadata.name} — no changes in consumed types [${consumes.join(', ')}]`);
+            }
+        }
+    }
+    /**
+     * Dequeue the next enricher from pending set, respecting topological order.
+     * Returns null if pending is empty.
+     */
+    dequeueNextEnricher(pending, sortedIds) {
+        for (const id of sortedIds) {
+            if (pending.has(id)) {
+                pending.delete(id);
+                return id;
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=PhaseRunner.js.map

package/dist/PhaseRunner.js.map

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

package/dist/config/ConfigLoader.d.ts

@@ -1,4 +1,4 @@
-import type { ServiceDefinition } from '@grafema/types';
+import type { ServiceDefinition, RoutingRule } from '@grafema/types';
 /**
  * Grafema configuration schema.
  *
@@ -32,6 +32,14 @@ import type { ServiceDefinition } from '@grafema/types';
  * If 'services' is specified and non-empty, auto-discovery plugins are skipped entirely.
  */
 export interface GrafemaConfig {
+    /**
+     * Config schema version (major.minor.patch, no pre-release tag).
+     * Must be compatible with the running Grafema version.
+     * If omitted, no version check is performed (backward compatibility).
+     *
+     * @example "0.2.5"
+     */
+    version?: string;
     plugins: {
         discovery?: string[];
         indexing: string[];
@@ -54,6 +62,22 @@ export interface GrafemaConfig {
      * See OrchestratorConfig.exclude for documentation.
      */
     exclude?: string[];
+    /**
+     * Routing rules for cross-service URL mapping (REG-256).
+     * Describes how infrastructure (nginx, gateway) transforms URLs between services.
+     *
+     * @example
+     * ```yaml
+     * routing:
+     *   - from: frontend
+     *     to: backend
+     *     stripPrefix: /api
+     *   - from: frontend
+     *     to: auth-service
+     *     stripPrefix: /auth
+     * ```
+     */
+    routing?: RoutingRule[];
     /**
      * Enable strict mode for fail-fast debugging.
      * When true, analysis fails if enrichers cannot resolve references.
@@ -115,6 +139,17 @@ export declare const DEFAULT_CONFIG: GrafemaConfig;
 export declare function loadConfig(projectPath: string, logger?: {
     warn: (msg: string) => void;
 }): GrafemaConfig;
+/**
+ * Validate config version compatibility with running Grafema version.
+ * THROWS on error (fail loudly per project convention).
+ *
+ * Compares major.minor.patch (pre-release tags are stripped).
+ * If config has no version field, validation passes silently (backward compat).
+ *
+ * @param configVersion - Version string from config file (may be undefined)
+ * @param currentVersion - Override for testing (defaults to GRAFEMA_VERSION)
+ */
+export declare function validateVersion(configVersion: unknown, currentVersion?: string): void;
 /**
  * Validate services array structure.
  * THROWS on error (fail loudly per Linus review).
@@ -137,6 +172,21 @@ export declare function validateServices(services: unknown, projectPath: string)
  * @param projectPath - Project root for path validation
  */
 export declare function validateWorkspace(workspace: unknown, projectPath: string): void;
+/**
+ * Validate routing rules structure (REG-256).
+ * THROWS on error (fail loudly per project convention).
+ *
+ * Validation rules:
+ * 1. Must be an array if provided
+ * 2. Each rule must have 'from' and 'to' as non-empty strings
+ * 3. 'stripPrefix' must start with '/' if provided
+ * 4. 'addPrefix' must start with '/' if provided
+ * 5. 'from' and 'to' must reference services defined in the services array
+ *
+ * @param routing - Parsed routing rules (may be undefined)
+ * @param services - Parsed services array (for cross-validation)
+ */
+export declare function validateRouting(routing: unknown, services: ServiceDefinition[]): void;
 /**
  * Validate include/exclude patterns.
  * THROWS on error (fail loudly per project convention).

package/dist/config/ConfigLoader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigLoader.d.ts","sourceRoot":"","sources":["../../src/config/ConfigLoader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF;;;OAGG;IACH,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAE9B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,aAuC5B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAY,GAChD,aAAa,CA0Ef;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA8D7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA+D/E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACtC,IAAI,CAkCN"}
+{"version":3,"file":"ConfigLoader.d.ts","sourceRoot":"","sources":["../../src/config/ConfigLoader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAGrE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,OAAO,EAAE;QACP,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IACF;;;OAGG;IACH,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAE9B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IAExB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,aA8C5B,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,MAAM,GAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAY,GAChD,aAAa,CAsFf;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,OAAO,EACtB,cAAc,CAAC,EAAE,MAAM,GACtB,IAAI,CAyBN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAqE7E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA+D/E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,GAAG,IAAI,CA8DrF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GACtC,IAAI,CAkCN"}

package/dist/config/ConfigLoader.js

@@ -1,11 +1,13 @@
 import { readFileSync, existsSync, statSync } from 'fs';
 import { join, basename } from 'path';
 import { parse as parseYAML } from 'yaml';
+import { GRAFEMA_VERSION, getSchemaVersion } from '../version.js';
 /**
  * Default plugin configuration.
  * Matches current DEFAULT_PLUGINS in analyze.ts and config.ts (MCP).
  */
 export const DEFAULT_CONFIG = {
+    version: getSchemaVersion(GRAFEMA_VERSION),
     plugins: {
         discovery: [],
         indexing: ['JSModuleIndexer'],
@@ -13,6 +15,7 @@ export const DEFAULT_CONFIG = {
             'JSASTAnalyzer',
             'ExpressRouteAnalyzer',
             'ExpressResponseAnalyzer',
+            'NestJSRouteAnalyzer',
             'SocketIOAnalyzer',
             'DatabaseAnalyzer',
             'FetchAnalyzer',
@@ -29,7 +32,9 @@ export const DEFAULT_CONFIG = {
             'ExpressHandlerLinker',
             'PrefixEvaluator',
             'ImportExportLinker',
-            'HTTPConnectionEnricher',
+            'ConfigRoutingMapBuilder',
+            'ServiceConnectionEnricher',
+            'CallbackCallResolver',
         ],
         validation: [
             'GraphConnectivityValidator',
@@ -37,9 +42,12 @@ export const DEFAULT_CONFIG = {
             'EvalBanValidator',
             'CallResolverValidator',
             'SQLInjectionValidator',
+            'AwaitInLoopValidator',
             'ShadowingDetector',
             'TypeScriptDeadCodeValidator',
             'BrokenImportValidator',
+            'UnconnectedRouteValidator',
+            'PackageCoverageValidator',
         ],
     },
     services: [], // Empty by default (uses auto-discovery)
@@ -87,6 +95,8 @@ export function loadConfig(projectPath, logger = console) {
             logger.warn('Using default configuration');
             return DEFAULT_CONFIG;
         }
+        // Validate version compatibility (THROWS on error) - REG-403
+        validateVersion(parsed.version);
         // Validate services array if present (THROWS on error per Linus review)
         // This is OUTSIDE try-catch - config errors MUST throw
         validateServices(parsed.services, projectPath);
@@ -94,6 +104,8 @@ export function loadConfig(projectPath, logger = console) {
         validatePatterns(parsed.include, parsed.exclude, logger);
         // Validate workspace.roots if present (THROWS on error) - REG-76
         validateWorkspace(parsed.workspace, projectPath);
+        // Validate routing rules if present (THROWS on error) - REG-256
+        validateRouting(parsed.routing, (parsed.services || []));
         // Merge with defaults (user config may be partial)
         return mergeConfig(DEFAULT_CONFIG, parsed);
     }
@@ -111,6 +123,8 @@ export function loadConfig(projectPath, logger = console) {
             logger.warn('Using default configuration');
             return DEFAULT_CONFIG;
         }
+        // Validate version compatibility (THROWS on error) - REG-403
+        validateVersion(parsed.version);
         // Validate services array if present (THROWS on error)
         // This is OUTSIDE try-catch - config errors MUST throw
         validateServices(parsed.services, projectPath);
@@ -118,11 +132,43 @@ export function loadConfig(projectPath, logger = console) {
         validatePatterns(parsed.include, parsed.exclude, logger);
         // Validate workspace.roots if present (THROWS on error) - REG-76
         validateWorkspace(parsed.workspace, projectPath);
+        // Validate routing rules if present (THROWS on error) - REG-256
+        validateRouting(parsed.routing, (parsed.services || []));
         return mergeConfig(DEFAULT_CONFIG, parsed);
     }
     // 3. No config file - return defaults
     return DEFAULT_CONFIG;
 }
+/**
+ * Validate config version compatibility with running Grafema version.
+ * THROWS on error (fail loudly per project convention).
+ *
+ * Compares major.minor.patch (pre-release tags are stripped).
+ * If config has no version field, validation passes silently (backward compat).
+ *
+ * @param configVersion - Version string from config file (may be undefined)
+ * @param currentVersion - Override for testing (defaults to GRAFEMA_VERSION)
+ */
+export function validateVersion(configVersion, currentVersion) {
+    // No version field = backward compat, accept silently
+    if (configVersion === undefined || configVersion === null) {
+        return;
+    }
+    if (typeof configVersion !== 'string') {
+        throw new Error(`Config error: version must be a string, got ${typeof configVersion}`);
+    }
+    if (!configVersion.trim()) {
+        throw new Error('Config error: version cannot be empty');
+    }
+    const current = currentVersion ?? GRAFEMA_VERSION;
+    const configSchema = getSchemaVersion(configVersion);
+    const currentSchema = getSchemaVersion(current);
+    if (configSchema !== currentSchema) {
+        throw new Error(`Config error: config version "${configVersion}" is not compatible with ` +
+            `Grafema ${current}. Expected "${currentSchema}".\n` +
+            `  Run: grafema init --force  (to regenerate config for current version)`);
+    }
+}
 /**
  * Validate services array structure.
  * THROWS on error (fail loudly per Linus review).
@@ -182,6 +228,12 @@ export function validateServices(services, projectPath) {
                 throw new Error(`Config error: services[${i}].entryPoint cannot be empty or whitespace-only`);
             }
         }
+        // customerFacing validation (optional field) - must be boolean if provided (REG-256)
+        if (svc.customerFacing !== undefined) {
+            if (typeof svc.customerFacing !== 'boolean') {
+                throw new Error(`Config error: services[${i}].customerFacing must be a boolean, got ${typeof svc.customerFacing}`);
+            }
+        }
     }
 }
 /**
@@ -249,6 +301,71 @@ export function validateWorkspace(workspace, projectPath) {
         seenNames.add(rootName);
     }
 }
+/**
+ * Validate routing rules structure (REG-256).
+ * THROWS on error (fail loudly per project convention).
+ *
+ * Validation rules:
+ * 1. Must be an array if provided
+ * 2. Each rule must have 'from' and 'to' as non-empty strings
+ * 3. 'stripPrefix' must start with '/' if provided
+ * 4. 'addPrefix' must start with '/' if provided
+ * 5. 'from' and 'to' must reference services defined in the services array
+ *
+ * @param routing - Parsed routing rules (may be undefined)
+ * @param services - Parsed services array (for cross-validation)
+ */
+export function validateRouting(routing, services) {
+    if (routing === undefined || routing === null)
+        return;
+    if (!Array.isArray(routing)) {
+        throw new Error(`Config error: routing must be an array, got ${typeof routing}`);
+    }
+    const serviceNames = new Set(services.map(s => s.name));
+    for (let i = 0; i < routing.length; i++) {
+        const rule = routing[i];
+        if (typeof rule !== 'object' || rule === null) {
+            throw new Error(`Config error: routing[${i}] must be an object`);
+        }
+        // from — required
+        if (typeof rule.from !== 'string' || !rule.from.trim()) {
+            throw new Error(`Config error: routing[${i}].from must be a non-empty string`);
+        }
+        // to — required
+        if (typeof rule.to !== 'string' || !rule.to.trim()) {
+            throw new Error(`Config error: routing[${i}].to must be a non-empty string`);
+        }
+        // Cross-validate against services (only if services are defined)
+        if (serviceNames.size > 0) {
+            if (!serviceNames.has(rule.from)) {
+                throw new Error(`Config error: routing[${i}].from "${rule.from}" does not match any service name. ` +
+                    `Available: ${[...serviceNames].join(', ')}`);
+            }
+            if (!serviceNames.has(rule.to)) {
+                throw new Error(`Config error: routing[${i}].to "${rule.to}" does not match any service name. ` +
+                    `Available: ${[...serviceNames].join(', ')}`);
+            }
+        }
+        // stripPrefix — optional, must start with /
+        if (rule.stripPrefix !== undefined) {
+            if (typeof rule.stripPrefix !== 'string') {
+                throw new Error(`Config error: routing[${i}].stripPrefix must be a string`);
+            }
+            if (!rule.stripPrefix.startsWith('/')) {
+                throw new Error(`Config error: routing[${i}].stripPrefix must start with '/'`);
+            }
+        }
+        // addPrefix — optional, must start with /
+        if (rule.addPrefix !== undefined) {
+            if (typeof rule.addPrefix !== 'string') {
+                throw new Error(`Config error: routing[${i}].addPrefix must be a string`);
+            }
+            if (!rule.addPrefix.startsWith('/')) {
+                throw new Error(`Config error: routing[${i}].addPrefix must start with '/'`);
+            }
+        }
+    }
+}
 /**
  * Validate include/exclude patterns.
  * THROWS on error (fail loudly per project convention).
@@ -302,6 +419,7 @@ export function validatePatterns(include, exclude, logger) {
  */
 function mergeConfig(defaults, user) {
     return {
+        version: user.version ?? defaults.version,
         plugins: {
             discovery: user.plugins?.discovery ?? defaults.plugins.discovery,
             indexing: user.plugins?.indexing ?? defaults.plugins.indexing,
@@ -316,6 +434,8 @@ function mergeConfig(defaults, user) {
         include: user.include ?? undefined,
         exclude: user.exclude ?? undefined,
         strict: user.strict ?? defaults.strict,
+        // Routing rules: pass through if specified (REG-256)
+        routing: user.routing ?? undefined,
         // Workspace config: pass through if specified (REG-76)
         workspace: user.workspace ?? undefined,
     };