@grafema/core 0.2.5-beta → 0.2.7

package/dist/plugins/validation/AwaitInLoopValidator.js

@@ -0,0 +1,69 @@
+/**
+ * AwaitInLoopValidator — detects sequential await in loops (REG-298)
+ *
+ * Performance issue: sequential `await` in a loop processes items one at a time
+ * when they could often be parallelized with `Promise.all()`.
+ *
+ * Detection: CALL nodes with `isAwaited=true AND isInsideLoop=true`
+ * (forward-registered during AST walk via `controlFlowState.loopDepth`).
+ *
+ * Creates `issue:performance` ISSUE nodes with AFFECTS edges to flagged calls.
+ *
+ * Datalog equivalent:
+ *   await_in_loop(Call) :-
+ *     node(Call, "CALL"),
+ *     attr(Call, "isAwaited", true),
+ *     attr(Call, "isInsideLoop", true).
+ */
+import { Plugin, createSuccessResult } from '../Plugin.js';
+export class AwaitInLoopValidator extends Plugin {
+    get metadata() {
+        return {
+            name: 'AwaitInLoopValidator',
+            phase: 'VALIDATION',
+            dependencies: ['JSASTAnalyzer'],
+            creates: {
+                nodes: ['ISSUE'],
+                edges: ['AFFECTS']
+            }
+        };
+    }
+    async execute(context) {
+        const { graph } = context;
+        const logger = this.log(context);
+        logger.info('Starting await-in-loop detection');
+        let issueCount = 0;
+        for await (const node of graph.queryNodes({ nodeType: 'CALL' })) {
+            const call = node;
+            if (call.isAwaited && call.isInsideLoop) {
+                const callName = call.name || 'unknown';
+                const location = `${call.file}:${call.line || '?'}`;
+                if (context.reportIssue) {
+                    await context.reportIssue({
+                        category: 'performance',
+                        severity: 'warning',
+                        message: `Sequential await in loop at ${location} — consider Promise.all() for parallel execution`,
+                        file: call.file || '',
+                        line: call.line || 0,
+                        column: call.column || 0,
+                        targetNodeId: call.id,
+                        context: {
+                            type: 'AWAIT_IN_LOOP',
+                            callName,
+                            suggestion: 'Promise.all'
+                        }
+                    });
+                    issueCount++;
+                }
+            }
+        }
+        if (issueCount > 0) {
+            logger.info('Sequential await-in-loop issues found', { count: issueCount });
+        }
+        else {
+            logger.info('No await-in-loop issues found');
+        }
+        return createSuccessResult({ nodes: issueCount, edges: issueCount }, { issueCount });
+    }
+}
+//# sourceMappingURL=AwaitInLoopValidator.js.map

package/dist/plugins/validation/AwaitInLoopValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AwaitInLoopValidator.js","sourceRoot":"","sources":["../../../src/plugins/validation/AwaitInLoopValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAa3D,MAAM,OAAO,oBAAqB,SAAQ,MAAM;IAC9C,IAAI,QAAQ;QACV,OAAO;YACL,IAAI,EAAE,sBAAsB;YAC5B,KAAK,EAAE,YAAY;YACnB,YAAY,EAAE,CAAC,eAAe,CAAC;YAC/B,OAAO,EAAE;gBACP,KAAK,EAAE,CAAC,OAAO,CAAC;gBAChB,KAAK,EAAE,CAAC,SAAS,CAAC;aACnB;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAsB;QAClC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEjC,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAEhD,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;YAChE,MAAM,IAAI,GAAG,IAA2B,CAAC;YAEzC,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC;gBACxC,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,GAAG,EAAE,CAAC;gBAEpD,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;oBACxB,MAAM,OAAO,CAAC,WAAW,CAAC;wBACxB,QAAQ,EAAE,aAAa;wBACvB,QAAQ,EAAE,SAAS;wBACnB,OAAO,EAAE,+BAA+B,QAAQ,kDAAkD;wBAClG,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE;wBACrB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC;wBACpB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC;wBACxB,YAAY,EAAE,IAAI,CAAC,EAAE;wBACrB,OAAO,EAAE;4BACP,IAAI,EAAE,eAAe;4BACrB,QAAQ;4BACR,UAAU,EAAE,aAAa;yBAC1B;qBACF,CAAC,CAAC;oBACH,UAAU,EAAE,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,uCAAuC,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QAC9E,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC/C,CAAC;QAED,OAAO,mBAAmB,CACxB,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,EACxC,EAAE,UAAU,EAAE,CACf,CAAC;IACJ,CAAC;CACF"}

package/dist/plugins/validation/PackageCoverageValidator.d.ts

@@ -0,0 +1,33 @@
+/**
+ * PackageCoverageValidator -- creates ISSUE nodes for external packages
+ * that are imported but have no semantic analyzer configured (REG-259).
+ *
+ * Reads the 'coverage:packages' resource from ResourceRegistry (populated
+ * by Orchestrator from plugin metadata `covers` fields) and compares
+ * against all IMPORT nodes with non-relative, non-builtin sources.
+ *
+ * Creates ONE issue:coverage ISSUE node per unique uncovered package
+ * (not per file or per import).
+ *
+ * Phase: VALIDATION
+ */
+import { Plugin } from '../Plugin.js';
+import type { PluginContext, PluginResult, PluginMetadata } from '../Plugin.js';
+import type { Resource } from '@grafema/types';
+/** Resource ID for the covered packages set. */
+export declare const COVERED_PACKAGES_RESOURCE_ID = "coverage:packages";
+/**
+ * Resource containing the set of package names covered by semantic analyzers.
+ * Populated by Orchestrator before the VALIDATION phase.
+ */
+export interface CoveredPackagesResource extends Resource {
+    readonly id: typeof COVERED_PACKAGES_RESOURCE_ID;
+    readonly packages: ReadonlySet<string>;
+}
+/** Factory for creating an empty CoveredPackagesResource. */
+export declare function createCoveredPackagesResource(packages: Set<string>): CoveredPackagesResource;
+export declare class PackageCoverageValidator extends Plugin {
+    get metadata(): PluginMetadata;
+    execute(context: PluginContext): Promise<PluginResult>;
+}
+//# sourceMappingURL=PackageCoverageValidator.d.ts.map

package/dist/plugins/validation/PackageCoverageValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PackageCoverageValidator.d.ts","sourceRoot":"","sources":["../../../src/plugins/validation/PackageCoverageValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,MAAM,EAAuB,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,gDAAgD;AAChD,eAAO,MAAM,4BAA4B,sBAAsB,CAAC;AAEhE;;;GAGG;AACH,MAAM,WAAW,uBAAwB,SAAQ,QAAQ;IACvD,QAAQ,CAAC,EAAE,EAAE,OAAO,4BAA4B,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACxC;AAED,6DAA6D;AAC7D,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,uBAAuB,CAK5F;AA8CD,qBAAa,wBAAyB,SAAQ,MAAM;IAClD,IAAI,QAAQ,IAAI,cAAc,CAU7B;IAEK,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CAoF7D"}

package/dist/plugins/validation/PackageCoverageValidator.js

@@ -0,0 +1,149 @@
+/**
+ * PackageCoverageValidator -- creates ISSUE nodes for external packages
+ * that are imported but have no semantic analyzer configured (REG-259).
+ *
+ * Reads the 'coverage:packages' resource from ResourceRegistry (populated
+ * by Orchestrator from plugin metadata `covers` fields) and compares
+ * against all IMPORT nodes with non-relative, non-builtin sources.
+ *
+ * Creates ONE issue:coverage ISSUE node per unique uncovered package
+ * (not per file or per import).
+ *
+ * Phase: VALIDATION
+ */
+import { builtinModules } from 'module';
+import { Plugin, createSuccessResult } from '../Plugin.js';
+/** Resource ID for the covered packages set. */
+export const COVERED_PACKAGES_RESOURCE_ID = 'coverage:packages';
+/** Factory for creating an empty CoveredPackagesResource. */
+export function createCoveredPackagesResource(packages) {
+    return {
+        id: COVERED_PACKAGES_RESOURCE_ID,
+        packages,
+    };
+}
+/** Set of Node.js builtin module names (without 'node:' prefix). */
+const NODE_BUILTINS = new Set(builtinModules);
+/**
+ * Check if an import source is a relative path (starts with . or /).
+ */
+function isRelativeImport(source) {
+    return source.startsWith('.') || source.startsWith('/');
+}
+/**
+ * Check if an import source is a Node.js builtin module.
+ * Handles the 'node:' prefix and subpath imports like 'fs/promises'.
+ */
+function isBuiltinModule(source) {
+    if (source.startsWith('node:')) {
+        return true;
+    }
+    // Handle subpath imports like 'fs/promises' -> check 'fs'
+    const baseModule = source.split('/')[0];
+    return NODE_BUILTINS.has(baseModule);
+}
+/**
+ * Extract the package name from an import source.
+ * Handles scoped packages (@scope/pkg) and subpath imports (lodash/map).
+ *
+ * Examples:
+ *   'lodash'          -> 'lodash'
+ *   'lodash/map'      -> 'lodash'
+ *   '@prisma/client'  -> '@prisma/client'
+ *   '@scope/pkg/util' -> '@scope/pkg'
+ */
+function extractPackageName(source) {
+    if (source.startsWith('@')) {
+        // Scoped package: @scope/pkg or @scope/pkg/subpath
+        const parts = source.split('/');
+        // Package name is @scope/pkg (first two parts)
+        return parts.length >= 2 ? `${parts[0]}/${parts[1]}` : source;
+    }
+    // Regular package: pkg or pkg/subpath
+    return source.split('/')[0];
+}
+export class PackageCoverageValidator extends Plugin {
+    get metadata() {
+        return {
+            name: 'PackageCoverageValidator',
+            phase: 'VALIDATION',
+            dependencies: [],
+            creates: {
+                nodes: ['ISSUE'],
+                edges: ['AFFECTS'],
+            },
+        };
+    }
+    async execute(context) {
+        const { graph } = context;
+        const logger = this.log(context);
+        // Get covered packages from ResourceRegistry
+        const resource = context.resources?.get(COVERED_PACKAGES_RESOURCE_ID);
+        const coveredPackages = resource?.packages ?? new Set();
+        logger.info('Starting package coverage check', {
+            coveredPackages: coveredPackages.size,
+        });
+        // Collect all external packages and track uncovered ones
+        const importedPackageNames = new Set();
+        const uncoveredPackages = new Map();
+        for await (const node of graph.queryNodes({ type: 'IMPORT' })) {
+            const source = node.source;
+            if (!source)
+                continue;
+            // Skip relative imports
+            if (isRelativeImport(source))
+                continue;
+            // Skip Node.js builtins
+            if (isBuiltinModule(source))
+                continue;
+            const packageName = extractPackageName(source);
+            importedPackageNames.add(packageName);
+            // Skip if already covered by a semantic analyzer
+            if (coveredPackages.has(packageName))
+                continue;
+            // Track first occurrence for the issue location
+            if (!uncoveredPackages.has(packageName)) {
+                uncoveredPackages.set(packageName, {
+                    file: node.file || '',
+                    line: node.line || 0,
+                });
+            }
+        }
+        // Report one issue per unique uncovered package
+        let issueCount = 0;
+        for (const [packageName, location] of uncoveredPackages) {
+            if (context.reportIssue) {
+                await context.reportIssue({
+                    category: 'coverage',
+                    severity: 'warning',
+                    message: `Package '${packageName}' is imported but no semantic analyzer is configured for it`,
+                    file: location.file,
+                    line: location.line,
+                    context: {
+                        type: 'UNCOVERED_PACKAGE',
+                        packageName,
+                    },
+                });
+                issueCount++;
+            }
+        }
+        const coveredCount = [...importedPackageNames].filter(p => coveredPackages.has(p)).length;
+        const summary = {
+            importedPackages: importedPackageNames.size,
+            coveredPackages: coveredCount,
+            uncoveredPackages: uncoveredPackages.size,
+            issuesCreated: issueCount,
+        };
+        if (uncoveredPackages.size > 0) {
+            logger.info('Uncovered packages found', {
+                count: uncoveredPackages.size,
+                packages: [...uncoveredPackages.keys()],
+            });
+        }
+        else {
+            logger.info('All external packages are covered');
+        }
+        return createSuccessResult({ nodes: issueCount, edges: issueCount }, { summary });
+    }
+}
+//# sourceMappingURL=PackageCoverageValidator.js.map

package/dist/plugins/validation/PackageCoverageValidator.js.map

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

package/dist/plugins/validation/UnconnectedRouteValidator.d.ts

@@ -0,0 +1,18 @@
+/**
+ * UnconnectedRouteValidator -- creates ISSUE nodes for customer-facing routes
+ * that have no frontend consumers (REG-256).
+ *
+ * Only checks routes marked with customerFacing: true (set by ServiceConnectionEnricher).
+ * Routes without the flag are considered internal and don't raise issues.
+ *
+ * Creates issue:connectivity ISSUE nodes with AFFECTS edges to flagged routes.
+ *
+ * Phase: VALIDATION
+ */
+import { Plugin } from '../Plugin.js';
+import type { PluginContext, PluginResult, PluginMetadata } from '../Plugin.js';
+export declare class UnconnectedRouteValidator extends Plugin {
+    get metadata(): PluginMetadata;
+    execute(context: PluginContext): Promise<PluginResult>;
+}
+//# sourceMappingURL=UnconnectedRouteValidator.d.ts.map

package/dist/plugins/validation/UnconnectedRouteValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnconnectedRouteValidator.d.ts","sourceRoot":"","sources":["../../../src/plugins/validation/UnconnectedRouteValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAuB,MAAM,cAAc,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAchF,qBAAa,yBAA0B,SAAQ,MAAM;IACnD,IAAI,QAAQ,IAAI,cAAc,CAU7B;IAEK,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CAoD7D"}

package/dist/plugins/validation/UnconnectedRouteValidator.js

@@ -0,0 +1,68 @@
+/**
+ * UnconnectedRouteValidator -- creates ISSUE nodes for customer-facing routes
+ * that have no frontend consumers (REG-256).
+ *
+ * Only checks routes marked with customerFacing: true (set by ServiceConnectionEnricher).
+ * Routes without the flag are considered internal and don't raise issues.
+ *
+ * Creates issue:connectivity ISSUE nodes with AFFECTS edges to flagged routes.
+ *
+ * Phase: VALIDATION
+ */
+import { Plugin, createSuccessResult } from '../Plugin.js';
+export class UnconnectedRouteValidator extends Plugin {
+    get metadata() {
+        return {
+            name: 'UnconnectedRouteValidator',
+            phase: 'VALIDATION',
+            dependencies: [],
+            creates: {
+                nodes: ['ISSUE'],
+                edges: ['AFFECTS'],
+            },
+        };
+    }
+    async execute(context) {
+        const { graph } = context;
+        const logger = this.log(context);
+        logger.info('Starting unconnected route check');
+        let issueCount = 0;
+        for await (const node of graph.queryNodes({ type: 'http:route' })) {
+            const route = node;
+            // Only check customer-facing routes
+            if (!route.customerFacing)
+                continue;
+            // Check for incoming INTERACTS_WITH edges (frontend consumers)
+            const incoming = await graph.getIncomingEdges(route.id, ['INTERACTS_WITH']);
+            if (incoming.length === 0) {
+                const routePath = route.fullPath || route.path || '';
+                const method = route.method || 'UNKNOWN';
+                if (context.reportIssue) {
+                    await context.reportIssue({
+                        category: 'connectivity',
+                        severity: 'warning',
+                        message: `Customer-facing route ${method} ${routePath} has no frontend consumers`,
+                        file: route.file || '',
+                        line: route.line || 0,
+                        column: route.column || 0,
+                        targetNodeId: route.id,
+                        context: {
+                            type: 'UNCONNECTED_CUSTOMER_ROUTE',
+                            method,
+                            path: routePath,
+                        },
+                    });
+                    issueCount++;
+                }
+            }
+        }
+        if (issueCount > 0) {
+            logger.info('Unconnected customer-facing routes found', { count: issueCount });
+        }
+        else {
+            logger.info('No unconnected customer-facing routes');
+        }
+        return createSuccessResult({ nodes: issueCount, edges: issueCount }, { issueCount });
+    }
+}
+//# sourceMappingURL=UnconnectedRouteValidator.js.map

package/dist/plugins/validation/UnconnectedRouteValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnconnectedRouteValidator.js","sourceRoot":"","sources":["../../../src/plugins/validation/UnconnectedRouteValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAe3D,MAAM,OAAO,yBAA0B,SAAQ,MAAM;IACnD,IAAI,QAAQ;QACV,OAAO;YACL,IAAI,EAAE,2BAA2B;YACjC,KAAK,EAAE,YAAY;YACnB,YAAY,EAAE,EAAE;YAChB,OAAO,EAAE;gBACP,KAAK,EAAE,CAAC,OAAO,CAAC;gBAChB,KAAK,EAAE,CAAC,SAAS,CAAC;aACnB;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAsB;QAClC,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;QAC1B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEjC,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;QAEhD,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;YAClE,MAAM,KAAK,GAAG,IAA4B,CAAC;YAE3C,oCAAoC;YACpC,IAAI,CAAC,KAAK,CAAC,cAAc;gBAAE,SAAS;YAEpC,+DAA+D;YAC/D,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAE5E,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;gBACrD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,SAAS,CAAC;gBAEzC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;oBACxB,MAAM,OAAO,CAAC,WAAW,CAAC;wBACxB,QAAQ,EAAE,cAAc;wBACxB,QAAQ,EAAE,SAAS;wBACnB,OAAO,EAAE,yBAAyB,MAAM,IAAI,SAAS,4BAA4B;wBACjF,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE;wBACtB,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC;wBACrB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC;wBACzB,YAAY,EAAE,KAAK,CAAC,EAAE;wBACtB,OAAO,EAAE;4BACP,IAAI,EAAE,4BAA4B;4BAClC,MAAM;4BACN,IAAI,EAAE,SAAS;yBAChB;qBACF,CAAC,CAAC;oBACH,UAAU,EAAE,CAAC;gBACf,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,MAAM,CAAC,IAAI,CAAC,0CAA0C,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;QACvD,CAAC;QAED,OAAO,mBAAmB,CACxB,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,EACxC,EAAE,UAAU,EAAE,CACf,CAAC;IACJ,CAAC;CACF"}

package/dist/queries/NodeContext.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Node Context — shared data logic for building node neighborhood context
+ *
+ * Extracts source code preview and all incoming/outgoing edges
+ * for a given node, grouped by edge type.
+ *
+ * Used by CLI (grafema context) and MCP (get_context tool).
+ * Consumers handle their own formatting; this module provides data only.
+ *
+ * @module queries/NodeContext
+ */
+import type { BaseNodeRecord, EdgeRecord } from '@grafema/types';
+interface GraphBackend {
+    getNode(id: string): Promise<BaseNodeRecord | null>;
+    getOutgoingEdges(nodeId: string, edgeTypes?: string[] | null): Promise<EdgeRecord[]>;
+    getIncomingEdges(nodeId: string, edgeTypes?: string[] | null): Promise<EdgeRecord[]>;
+}
+/**
+ * Edge types that are structural/containment — shown in compact form.
+ * These describe HOW code is nested, not WHAT it does.
+ */
+export declare const STRUCTURAL_EDGE_TYPES: Set<string>;
+export interface EdgeWithNode {
+    edge: EdgeRecord;
+    node: BaseNodeRecord | null;
+}
+export interface EdgeGroup {
+    edgeType: string;
+    edges: EdgeWithNode[];
+}
+export interface SourcePreview {
+    file: string;
+    startLine: number;
+    endLine: number;
+    lines: string[];
+}
+export interface NodeContext {
+    node: BaseNodeRecord;
+    source: SourcePreview | null;
+    outgoing: EdgeGroup[];
+    incoming: EdgeGroup[];
+}
+export interface BuildNodeContextOptions {
+    /** Lines of context before the highlighted line (default: 3) */
+    contextLines?: number;
+    /** Filter to only these edge types (null = show all) */
+    edgeTypeFilter?: Set<string> | null;
+    /**
+     * DI callback for reading file content.
+     * Return file content as string, or null if file can't be read.
+     * Default uses fs.readFileSync.
+     */
+    readFileContent?: (filePath: string) => string | null;
+}
+/**
+ * Build full node context: source preview + all edges with connected nodes.
+ *
+ * @param backend  - Graph backend for queries
+ * @param node     - The node to build context for (already looked up by caller)
+ * @param options  - Context options
+ * @returns NodeContext with source preview and grouped edges
+ */
+export declare function buildNodeContext(backend: GraphBackend, node: BaseNodeRecord, options?: BuildNodeContextOptions): Promise<NodeContext>;
+/**
+ * Get display name for a node based on its type.
+ *
+ * Special cases:
+ * - HTTP routes: "METHOD /path"
+ * - HTTP requests: "METHOD url"
+ * - Socket.IO: event name
+ * - Default: node.name or node.id
+ */
+export declare function getNodeDisplayName(node: BaseNodeRecord): string;
+/**
+ * Format edge metadata for inline display (only meaningful fields).
+ *
+ * Returns a string like "  [arg0]" or "" if no relevant metadata.
+ */
+export declare function formatEdgeMetadata(edge: EdgeRecord): string;
+export {};
+//# sourceMappingURL=NodeContext.d.ts.map

package/dist/queries/NodeContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeContext.d.ts","sourceRoot":"","sources":["../../src/queries/NodeContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAMjE,UAAU,YAAY;IACpB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACpD,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GAC1B,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IACzB,gBAAgB,CACd,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,GAC1B,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;CAC1B;AAMD;;;GAGG;AACH,eAAO,MAAM,qBAAqB,aAuBhC,CAAC;AAMH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,cAAc,CAAC;IACrB,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,wDAAwD;IACxD,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACpC;;;;OAIG;IACH,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CACvD;AAmBD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,cAAc,EACpB,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,WAAW,CAAC,CAkCtB;AAkDD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAsB/D;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAoB3D"}

package/dist/queries/NodeContext.js

@@ -0,0 +1,193 @@
+/**
+ * Node Context — shared data logic for building node neighborhood context
+ *
+ * Extracts source code preview and all incoming/outgoing edges
+ * for a given node, grouped by edge type.
+ *
+ * Used by CLI (grafema context) and MCP (get_context tool).
+ * Consumers handle their own formatting; this module provides data only.
+ *
+ * @module queries/NodeContext
+ */
+import { existsSync, readFileSync } from 'fs';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/**
+ * Edge types that are structural/containment — shown in compact form.
+ * These describe HOW code is nested, not WHAT it does.
+ */
+export const STRUCTURAL_EDGE_TYPES = new Set([
+    'CONTAINS',
+    'HAS_SCOPE',
+    'DECLARES',
+    'DEFINES',
+    'HAS_CONDITION',
+    'HAS_CASE',
+    'HAS_DEFAULT',
+    'HAS_CONSEQUENT',
+    'HAS_ALTERNATE',
+    'HAS_BODY',
+    'HAS_INIT',
+    'HAS_UPDATE',
+    'HAS_CATCH',
+    'HAS_FINALLY',
+    'HAS_PARAMETER',
+    'HAS_PROPERTY',
+    'HAS_ELEMENT',
+    'USES',
+    'GOVERNS',
+    'VIOLATES',
+    'AFFECTS',
+    'UNKNOWN',
+]);
+// ---------------------------------------------------------------------------
+// Default file reader
+// ---------------------------------------------------------------------------
+function defaultReadFileContent(filePath) {
+    if (!existsSync(filePath))
+        return null;
+    try {
+        return readFileSync(filePath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Core function
+// ---------------------------------------------------------------------------
+/**
+ * Build full node context: source preview + all edges with connected nodes.
+ *
+ * @param backend  - Graph backend for queries
+ * @param node     - The node to build context for (already looked up by caller)
+ * @param options  - Context options
+ * @returns NodeContext with source preview and grouped edges
+ */
+export async function buildNodeContext(backend, node, options = {}) {
+    const { contextLines = 3, edgeTypeFilter = null, readFileContent = defaultReadFileContent, } = options;
+    // Source code preview
+    let source = null;
+    if (node.file && node.line) {
+        const content = readFileContent(node.file);
+        if (content) {
+            const allLines = content.split('\n');
+            const line = node.line;
+            const startLine = Math.max(1, line - contextLines);
+            const endLine = Math.min(allLines.length, line + contextLines + 12);
+            source = {
+                file: node.file,
+                startLine,
+                endLine,
+                lines: allLines.slice(startLine - 1, endLine),
+            };
+        }
+    }
+    // Outgoing edges
+    const rawOutgoing = await backend.getOutgoingEdges(node.id);
+    const outgoing = await groupEdges(backend, rawOutgoing, 'dst', edgeTypeFilter);
+    // Incoming edges
+    const rawIncoming = await backend.getIncomingEdges(node.id);
+    const incoming = await groupEdges(backend, rawIncoming, 'src', edgeTypeFilter);
+    return { node, source, outgoing, incoming };
+}
+// ---------------------------------------------------------------------------
+// Edge grouping
+// ---------------------------------------------------------------------------
+/**
+ * Group edges by type and resolve connected nodes.
+ *
+ * Sort order: non-structural edges first (alphabetical),
+ * then structural edges (alphabetical).
+ */
+async function groupEdges(backend, edges, nodeField, edgeTypeFilter) {
+    const groups = new Map();
+    for (const edge of edges) {
+        const edgeType = edge.type || 'UNKNOWN';
+        // Apply edge type filter
+        if (edgeTypeFilter && !edgeTypeFilter.has(edgeType))
+            continue;
+        const connectedId = edge[nodeField];
+        const connectedNode = await backend.getNode(connectedId);
+        if (!groups.has(edgeType)) {
+            groups.set(edgeType, []);
+        }
+        groups.get(edgeType).push({ edge, node: connectedNode });
+    }
+    // Sort groups: primary edges first, then structural
+    return Array.from(groups.entries())
+        .sort(([a], [b]) => {
+        const aStructural = STRUCTURAL_EDGE_TYPES.has(a);
+        const bStructural = STRUCTURAL_EDGE_TYPES.has(b);
+        if (aStructural !== bStructural)
+            return aStructural ? 1 : -1;
+        return a.localeCompare(b);
+    })
+        .map(([edgeType, edgeList]) => ({ edgeType, edges: edgeList }));
+}
+// ---------------------------------------------------------------------------
+// Display helpers
+// ---------------------------------------------------------------------------
+/**
+ * Get display name for a node based on its type.
+ *
+ * Special cases:
+ * - HTTP routes: "METHOD /path"
+ * - HTTP requests: "METHOD url"
+ * - Socket.IO: event name
+ * - Default: node.name or node.id
+ */
+export function getNodeDisplayName(node) {
+    // HTTP nodes: method + path/url
+    if (node.type === 'http:route') {
+        const method = node.method;
+        const path = node.path;
+        if (method && path)
+            return `${method} ${path}`;
+    }
+    if (node.type === 'http:request') {
+        const method = node.method;
+        const url = node.url;
+        if (method && url)
+            return `${method} ${url}`;
+    }
+    // Socket.IO: event name
+    if (node.type === 'socketio:emit' || node.type === 'socketio:on') {
+        const event = node.event;
+        if (event)
+            return event;
+    }
+    // Default: name or ID fallback
+    if (node.name && !node.name.startsWith('{'))
+        return node.name;
+    return node.id;
+}
+/**
+ * Format edge metadata for inline display (only meaningful fields).
+ *
+ * Returns a string like "  [arg0]" or "" if no relevant metadata.
+ */
+export function formatEdgeMetadata(edge) {
+    const parts = [];
+    const meta = edge.metadata || {};
+    if (edge.type === 'PASSES_ARGUMENT' || edge.type === 'RECEIVES_ARGUMENT') {
+        if ('argIndex' in meta) {
+            parts.push(`arg${meta.argIndex}`);
+        }
+    }
+    if (edge.type === 'FLOWS_INTO') {
+        if ('mutationMethod' in meta)
+            parts.push(`via ${meta.mutationMethod}`);
+    }
+    if (edge.type === 'HAS_PROPERTY') {
+        if ('propertyName' in meta)
+            parts.push(`key: ${meta.propertyName}`);
+    }
+    if (edge.type === 'ITERATES_OVER') {
+        if ('iterates' in meta)
+            parts.push(`${meta.iterates}`);
+    }
+    return parts.length > 0 ? `  [${parts.join(', ')}]` : '';
+}
+//# sourceMappingURL=NodeContext.js.map

package/dist/queries/NodeContext.js.map

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