@grafema/core 0.1.0-alpha.4 → 0.1.1-alpha

package/dist/core/SemanticId.js

@@ -0,0 +1,115 @@
+/**
+ * SemanticId - Stable identifiers for code elements
+ *
+ * Semantic IDs provide stable identifiers for code elements that don't change
+ * when unrelated code is added/removed (no line numbers in IDs).
+ *
+ * Format: {file}->{scope_path}->{type}->{name}[#discriminator]
+ *
+ * Examples:
+ *   src/app.js->global->FUNCTION->processData
+ *   src/app.js->UserService->METHOD->login
+ *   src/app.js->getUser->if#0->CALL->console.log#0
+ *
+ * Special formats:
+ *   Singletons: net:stdio->__stdio__
+ *   External modules: EXTERNAL_MODULE->lodash
+ */
+/**
+ * Compute semantic ID for any node type.
+ *
+ * @param type - Node type (FUNCTION, CALL, VARIABLE, etc.)
+ * @param name - Node name
+ * @param context - Scope context from ScopeTracker
+ * @param options - Optional discriminator or context
+ * @returns Semantic ID string
+ */
+export function computeSemanticId(type, name, context, options) {
+    const { file, scopePath } = context;
+    const scope = scopePath.length > 0 ? scopePath.join('->') : 'global';
+    let id = `${file}->${scope}->${type}->${name}`;
+    if (options?.discriminator !== undefined) {
+        id += `#${options.discriminator}`;
+    }
+    else if (options?.context) {
+        id += `[${options.context}]`;
+    }
+    return id;
+}
+/**
+ * Parse semantic ID back to components.
+ *
+ * @param id - Semantic ID to parse
+ * @returns Parsed components or null if invalid
+ */
+export function parseSemanticId(id) {
+    // Handle singletons
+    if (id.startsWith('net:stdio') || id.startsWith('net:request')) {
+        const [prefix, name] = id.split('->');
+        return {
+            file: '',
+            scopePath: [prefix],
+            type: 'SINGLETON',
+            name,
+            discriminator: undefined
+        };
+    }
+    if (id.startsWith('EXTERNAL_MODULE')) {
+        const [, name] = id.split('->');
+        return {
+            file: '',
+            scopePath: [],
+            type: 'EXTERNAL_MODULE',
+            name,
+            discriminator: undefined
+        };
+    }
+    const parts = id.split('->');
+    if (parts.length < 4)
+        return null;
+    const file = parts[0];
+    const type = parts[parts.length - 2];
+    let name = parts[parts.length - 1];
+    const scopePath = parts.slice(1, -2);
+    // Parse discriminator or context
+    let discriminator;
+    let context;
+    const hashMatch = name.match(/^(.+)#(\d+)$/);
+    if (hashMatch) {
+        name = hashMatch[1];
+        discriminator = parseInt(hashMatch[2], 10);
+    }
+    const bracketMatch = name.match(/^(.+)\[(.+)\]$/);
+    if (bracketMatch) {
+        name = bracketMatch[1];
+        context = bracketMatch[2];
+    }
+    return { file, scopePath, type, name, discriminator, context };
+}
+/**
+ * Compute discriminator for items with same name in same scope.
+ * Uses line/column for stable ordering.
+ *
+ * @param items - All items in scope
+ * @param targetName - Name to find discriminator for
+ * @param targetLocation - Location of target item
+ * @returns Discriminator (0-based index among same-named items)
+ */
+export function computeDiscriminator(items, targetName, targetLocation) {
+    // Filter items with same name
+    const sameNameItems = items.filter(item => item.name === targetName);
+    if (sameNameItems.length <= 1) {
+        return 0;
+    }
+    // Sort by line, then by column for stable ordering
+    sameNameItems.sort((a, b) => {
+        if (a.location.line !== b.location.line) {
+            return a.location.line - b.location.line;
+        }
+        return a.location.column - b.location.column;
+    });
+    // Find index of target
+    const index = sameNameItems.findIndex(item => item.location.line === targetLocation.line &&
+        item.location.column === targetLocation.column);
+    return index >= 0 ? index : 0;
+}

package/dist/core/VersionManager.d.ts.map

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

package/dist/core/VersionManager.js

@@ -36,9 +36,10 @@ export class VersionManager {
         if (type === 'VARIABLE_DECLARATION') {
             return `${type}:${name}:${file}:${line || 0}`;
         }
-        // Для MODULE - только file
+        // Для MODULE - use semantic ID format with name (relative path)
         if (type === 'MODULE') {
-            return `MODULE:${file}`;
+            // name stores the relative path for MODULE nodes
+            return `${name}->global->MODULE->module`;
         }
         // Для SERVICE - используем имя или file
         if (type === 'SERVICE') {

package/dist/core/nodes/ArgumentExpressionNode.d.ts

@@ -0,0 +1,43 @@
+/**
+ * ArgumentExpressionNode - EXPRESSION node with call argument context
+ *
+ * Extends ExpressionNode with fields tracking which call and argument position
+ * this expression appears in. Used for argument data flow tracking.
+ *
+ * ID format: {file}:EXPRESSION:{expressionType}:{line}:{column}
+ * With counter: {file}:EXPRESSION:{expressionType}:{line}:{column}:{counter}
+ *
+ * Example: /src/app.ts:EXPRESSION:BinaryExpression:25:10
+ *
+ * Note: Uses counter suffix since same expression at same position can appear
+ * multiple times in different argument contexts.
+ */
+import { type ExpressionNodeRecord, type ExpressionNodeOptions } from './ExpressionNode.js';
+interface ArgumentExpressionNodeRecord extends ExpressionNodeRecord {
+    parentCallId: string;
+    argIndex: number;
+}
+interface ArgumentExpressionNodeOptions extends ExpressionNodeOptions {
+    parentCallId: string;
+    argIndex: number;
+    counter?: number;
+}
+export declare class ArgumentExpressionNode {
+    static readonly TYPE: "EXPRESSION";
+    static readonly REQUIRED: readonly string[];
+    static readonly OPTIONAL: readonly string[];
+    /**
+     * Create EXPRESSION node with argument context
+     *
+     * @param expressionType - Type of expression (BinaryExpression, LogicalExpression, etc.)
+     * @param file - File path
+     * @param line - Line number
+     * @param column - Column position
+     * @param options - Required: parentCallId, argIndex; Optional: expression properties, counter
+     * @returns ArgumentExpressionNodeRecord
+     */
+    static create(expressionType: string, file: string, line: number, column: number, options: ArgumentExpressionNodeOptions): ArgumentExpressionNodeRecord;
+    static validate(node: ArgumentExpressionNodeRecord): string[];
+}
+export type { ArgumentExpressionNodeRecord, ArgumentExpressionNodeOptions };
+//# sourceMappingURL=ArgumentExpressionNode.d.ts.map

package/dist/core/nodes/ArgumentExpressionNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArgumentExpressionNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ArgumentExpressionNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAkB,KAAK,oBAAoB,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5G,UAAU,4BAA6B,SAAQ,oBAAoB;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,6BAA8B,SAAQ,qBAAqB;IACnE,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,sBAAsB;IAEjC,MAAM,CAAC,QAAQ,CAAC,IAAI,eAAuB;IAC3C,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAA4D;IACvG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAA2C;IAEtF;;;;;;;;;OASG;IACH,MAAM,CAAC,MAAM,CACX,cAAc,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,6BAA6B,GACrC,4BAA4B;IAuB/B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,4BAA4B,GAAG,MAAM,EAAE;CAa9D;AAED,YAAY,EAAE,4BAA4B,EAAE,6BAA6B,EAAE,CAAC"}

package/dist/core/nodes/ArgumentExpressionNode.js

@@ -0,0 +1,60 @@
+/**
+ * ArgumentExpressionNode - EXPRESSION node with call argument context
+ *
+ * Extends ExpressionNode with fields tracking which call and argument position
+ * this expression appears in. Used for argument data flow tracking.
+ *
+ * ID format: {file}:EXPRESSION:{expressionType}:{line}:{column}
+ * With counter: {file}:EXPRESSION:{expressionType}:{line}:{column}:{counter}
+ *
+ * Example: /src/app.ts:EXPRESSION:BinaryExpression:25:10
+ *
+ * Note: Uses counter suffix since same expression at same position can appear
+ * multiple times in different argument contexts.
+ */
+import { ExpressionNode } from './ExpressionNode.js';
+export class ArgumentExpressionNode {
+    // Inherit TYPE from ExpressionNode
+    static TYPE = ExpressionNode.TYPE;
+    static REQUIRED = [...ExpressionNode.REQUIRED, 'parentCallId', 'argIndex'];
+    static OPTIONAL = [...ExpressionNode.OPTIONAL, 'counter'];
+    /**
+     * Create EXPRESSION node with argument context
+     *
+     * @param expressionType - Type of expression (BinaryExpression, LogicalExpression, etc.)
+     * @param file - File path
+     * @param line - Line number
+     * @param column - Column position
+     * @param options - Required: parentCallId, argIndex; Optional: expression properties, counter
+     * @returns ArgumentExpressionNodeRecord
+     */
+    static create(expressionType, file, line, column, options) {
+        if (!options.parentCallId) {
+            throw new Error('ArgumentExpressionNode.create: parentCallId is required');
+        }
+        if (options.argIndex === undefined) {
+            throw new Error('ArgumentExpressionNode.create: argIndex is required');
+        }
+        // Create base EXPRESSION node using parent class
+        const baseNode = ExpressionNode.create(expressionType, file, line, column, options);
+        // Override ID with counter suffix (since same location can have multiple expressions)
+        const counter = options.counter !== undefined ? `:${options.counter}` : '';
+        const id = `${file}:EXPRESSION:${expressionType}:${line}:${column}${counter}`;
+        return {
+            ...baseNode,
+            id,
+            parentCallId: options.parentCallId,
+            argIndex: options.argIndex
+        };
+    }
+    static validate(node) {
+        const errors = ExpressionNode.validate(node);
+        if (!node.parentCallId) {
+            errors.push('Missing required field: parentCallId');
+        }
+        if (node.argIndex === undefined) {
+            errors.push('Missing required field: argIndex');
+        }
+        return errors;
+    }
+}

package/dist/core/nodes/ArrayLiteralNode.d.ts

@@ -0,0 +1,27 @@
+/**
+ * ArrayLiteralNode - contract for ARRAY_LITERAL node
+ *
+ * Represents an array literal expression: [elem1, elem2, ...]
+ * Used for tracking data flow through array construction.
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+interface ArrayLiteralNodeRecord extends BaseNodeRecord {
+    type: 'ARRAY_LITERAL';
+    column: number;
+    parentCallId?: string;
+    argIndex?: number;
+}
+interface ArrayLiteralNodeOptions {
+    parentCallId?: string;
+    argIndex?: number;
+    counter?: number;
+}
+export declare class ArrayLiteralNode {
+    static readonly TYPE: "ARRAY_LITERAL";
+    static readonly REQUIRED: readonly ["file", "line", "column"];
+    static readonly OPTIONAL: readonly ["parentCallId", "argIndex"];
+    static create(file: string, line: number, column: number, options?: ArrayLiteralNodeOptions): ArrayLiteralNodeRecord;
+    static validate(node: ArrayLiteralNodeRecord): string[];
+}
+export type { ArrayLiteralNodeRecord, ArrayLiteralNodeOptions };
+//# sourceMappingURL=ArrayLiteralNode.d.ts.map

package/dist/core/nodes/ArrayLiteralNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayLiteralNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ArrayLiteralNode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,sBAAuB,SAAQ,cAAc;IACrD,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,uBAAuB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,gBAAgB;IAC3B,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,eAAe,CAAU;IAEhD,MAAM,CAAC,QAAQ,CAAC,QAAQ,sCAAuC;IAC/D,MAAM,CAAC,QAAQ,CAAC,QAAQ,wCAAyC;IAEjE,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,uBAA4B,GACpC,sBAAsB;IAoBzB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,GAAG,MAAM,EAAE;CASxD;AAED,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/core/nodes/ArrayLiteralNode.js

@@ -0,0 +1,41 @@
+/**
+ * ArrayLiteralNode - contract for ARRAY_LITERAL node
+ *
+ * Represents an array literal expression: [elem1, elem2, ...]
+ * Used for tracking data flow through array construction.
+ */
+export class ArrayLiteralNode {
+    static TYPE = 'ARRAY_LITERAL';
+    static REQUIRED = ['file', 'line', 'column'];
+    static OPTIONAL = ['parentCallId', 'argIndex'];
+    static create(file, line, column, options = {}) {
+        if (!file)
+            throw new Error('ArrayLiteralNode.create: file is required');
+        if (line === undefined)
+            throw new Error('ArrayLiteralNode.create: line is required');
+        const counter = options.counter !== undefined ? `:${options.counter}` : '';
+        const argSuffix = options.argIndex !== undefined ? `arg${options.argIndex}` : 'arr';
+        const id = `ARRAY_LITERAL#${argSuffix}#${file}#${line}:${column || 0}${counter}`;
+        return {
+            id,
+            type: this.TYPE,
+            name: `<array>`,
+            file,
+            line,
+            column: column || 0,
+            parentCallId: options.parentCallId,
+            argIndex: options.argIndex
+        };
+    }
+    static validate(node) {
+        const errors = [];
+        if (node.type !== this.TYPE)
+            errors.push(`Expected type ${this.TYPE}`);
+        const nodeRecord = node;
+        for (const field of this.REQUIRED) {
+            if (nodeRecord[field] === undefined)
+                errors.push(`Missing: ${field}`);
+        }
+        return errors;
+    }
+}

package/dist/core/nodes/CallSiteNode.d.ts

@@ -1,7 +1,15 @@
 /**
  * CallSiteNode - contract for CALL_SITE node
+ *
+ * Supports two creation modes:
+ * 1. createWithContext() - NEW: Uses ScopeContext + Location for semantic IDs
+ * 2. create() - LEGACY: Uses line-based IDs for backward compatibility
+ *
+ * Semantic ID format: {file}->{scope_path}->CALL->{calleeName}#N
+ * Example: src/app.js->handler->CALL->console.log#0
  */
 import type { BaseNodeRecord } from '@grafema/types';
+import { type ScopeContext, type Location } from '../SemanticId.js';
 interface CallSiteNodeRecord extends BaseNodeRecord {
     type: 'CALL_SITE';
     column: number;
@@ -12,6 +20,13 @@ interface CallSiteNodeOptions {
     parentScopeId?: string;
     counter?: number;
 }
+/**
+ * Options for createWithContext
+ */
+interface CallSiteContextOptions {
+    discriminator: number;
+    parentScopeId?: string;
+}
 export declare class CallSiteNode {
     static readonly TYPE: "CALL_SITE";
     static readonly REQUIRED: readonly ["name", "file", "line"];
@@ -20,6 +35,19 @@ export declare class CallSiteNode {
      * Create CALL_SITE node
      */
     static create(targetName: string, file: string, line: number, column: number, options?: CallSiteNodeOptions): CallSiteNodeRecord;
+    /**
+     * Create CALL_SITE node with semantic ID (NEW API)
+     *
+     * Uses ScopeContext from ScopeTracker for stable identifiers.
+     * Requires discriminator for multiple calls to same function within scope.
+     *
+     * @param targetName - Name of called function (e.g., 'console.log', 'db.query')
+     * @param context - Scope context from ScopeTracker.getContext()
+     * @param location - Source location { line, column }
+     * @param options - Options including required discriminator
+     * @returns CallSiteNodeRecord with semantic ID
+     */
+    static createWithContext(targetName: string, context: ScopeContext, location: Partial<Location>, options: CallSiteContextOptions): CallSiteNodeRecord;
     static validate(node: CallSiteNodeRecord): string[];
 }
 export type { CallSiteNodeRecord };

package/dist/core/nodes/CallSiteNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CallSiteNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/CallSiteNode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,kBAAmB,SAAQ,cAAc;IACjD,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,UAAU,mBAAmB;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IAE5C,MAAM,CAAC,QAAQ,CAAC,QAAQ,oCAAqC;IAC7D,MAAM,CAAC,QAAQ,CAAC,QAAQ,6DAA8D;IAEtF;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,mBAAwB,GAChC,kBAAkB;IAoBrB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,EAAE;CAgBpD;AAED,YAAY,EAAE,kBAAkB,EAAE,CAAC"}
+{"version":3,"file":"CallSiteNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/CallSiteNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAqB,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvF,UAAU,kBAAmB,SAAQ,cAAc;IACjD,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,UAAU,mBAAmB;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,UAAU,sBAAsB;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,YAAY;IACvB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IAE5C,MAAM,CAAC,QAAQ,CAAC,QAAQ,oCAAqC;IAC7D,MAAM,CAAC,QAAQ,CAAC,QAAQ,6DAA8D;IAEtF;;OAEG;IACH,MAAM,CAAC,MAAM,CACX,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,mBAAwB,GAChC,kBAAkB;IAoBrB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,iBAAiB,CACtB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC3B,OAAO,EAAE,sBAAsB,GAC9B,kBAAkB;IAyBrB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,EAAE;CAgBpD;AAED,YAAY,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/core/nodes/CallSiteNode.js

@@ -1,6 +1,14 @@
 /**
  * CallSiteNode - contract for CALL_SITE node
+ *
+ * Supports two creation modes:
+ * 1. createWithContext() - NEW: Uses ScopeContext + Location for semantic IDs
+ * 2. create() - LEGACY: Uses line-based IDs for backward compatibility
+ *
+ * Semantic ID format: {file}->{scope_path}->CALL->{calleeName}#N
+ * Example: src/app.js->handler->CALL->console.log#0
  */
+import { computeSemanticId } from '../SemanticId.js';
 export class CallSiteNode {
     static TYPE = 'CALL_SITE';
     static REQUIRED = ['name', 'file', 'line'];
@@ -28,6 +36,44 @@ export class CallSiteNode {
             targetFunctionName: targetName
         };
     }
+    /**
+     * Create CALL_SITE node with semantic ID (NEW API)
+     *
+     * Uses ScopeContext from ScopeTracker for stable identifiers.
+     * Requires discriminator for multiple calls to same function within scope.
+     *
+     * @param targetName - Name of called function (e.g., 'console.log', 'db.query')
+     * @param context - Scope context from ScopeTracker.getContext()
+     * @param location - Source location { line, column }
+     * @param options - Options including required discriminator
+     * @returns CallSiteNodeRecord with semantic ID
+     */
+    static createWithContext(targetName, context, location, options) {
+        // Validate required fields
+        if (!targetName)
+            throw new Error('CallSiteNode.createWithContext: targetName is required');
+        if (!context.file)
+            throw new Error('CallSiteNode.createWithContext: file is required');
+        if (location.line === undefined)
+            throw new Error('CallSiteNode.createWithContext: line is required');
+        if (options.discriminator === undefined)
+            throw new Error('CallSiteNode.createWithContext: discriminator is required');
+        // Compute semantic ID with discriminator
+        // Use 'CALL' as the type for cleaner IDs (matches spec)
+        const id = computeSemanticId('CALL', targetName, context, {
+            discriminator: options.discriminator
+        });
+        return {
+            id,
+            type: this.TYPE,
+            name: targetName,
+            file: context.file,
+            line: location.line,
+            column: location.column ?? 0,
+            parentScopeId: options.parentScopeId,
+            targetFunctionName: targetName
+        };
+    }
     static validate(node) {
         const errors = [];
         if (node.type !== this.TYPE) {

package/dist/core/nodes/ClassNode.d.ts

@@ -1,24 +1,56 @@
 /**
  * ClassNode - contract for CLASS node
+ *
+ * Supports two creation modes:
+ * 1. createWithContext() - NEW: Uses ScopeContext + Location for semantic IDs
+ * 2. create() - LEGACY: Uses line-based IDs for backward compatibility
+ *
+ * Semantic ID format: {file}->{scope_path}->CLASS->{name}
+ * Example: src/models/User.js->global->CLASS->User
  */
 import type { BaseNodeRecord } from '@grafema/types';
+import { type ScopeContext, type Location } from '../SemanticId.js';
 interface ClassNodeRecord extends BaseNodeRecord {
     type: 'CLASS';
     column: number;
     exported: boolean;
     superClass?: string;
     methods: string[];
+    isInstantiationRef?: boolean;
 }
 interface ClassNodeOptions {
     exported?: boolean;
     superClass?: string;
     methods?: string[];
+    isInstantiationRef?: boolean;
+}
+/**
+ * Options for createWithContext
+ */
+interface ClassContextOptions {
+    exported?: boolean;
+    superClass?: string;
+    methods?: string[];
+    isInstantiationRef?: boolean;
 }
 export declare class ClassNode {
     static readonly TYPE: "CLASS";
     static readonly REQUIRED: readonly ["name", "file", "line"];
-    static readonly OPTIONAL: readonly ["column", "exported", "superClass", "methods"];
+    static readonly OPTIONAL: readonly ["column", "exported", "superClass", "methods", "isInstantiationRef"];
     static create(name: string, file: string, line: number, column: number, options?: ClassNodeOptions): ClassNodeRecord;
+    /**
+     * Create CLASS node with semantic ID (NEW API)
+     *
+     * Uses ScopeContext from ScopeTracker for stable identifiers.
+     * Class names are unique within scope, so no discriminator needed.
+     *
+     * @param name - Class name
+     * @param context - Scope context from ScopeTracker.getContext()
+     * @param location - Source location { line, column }
+     * @param options - Optional class properties
+     * @returns ClassNodeRecord with semantic ID
+     */
+    static createWithContext(name: string, context: ScopeContext, location: Partial<Location>, options?: ClassContextOptions): ClassNodeRecord;
     static validate(node: ClassNodeRecord): string[];
 }
 export type { ClassNodeRecord };

package/dist/core/nodes/ClassNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ClassNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ClassNode.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,UAAU,eAAgB,SAAQ,cAAc;IAC9C,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,qBAAa,SAAS;IACpB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAExC,MAAM,CAAC,QAAQ,CAAC,QAAQ,oCAAqC;IAC7D,MAAM,CAAC,QAAQ,CAAC,QAAQ,2DAA4D;IAEpF,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,eAAe;IAkBlB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE;CAgBjD;AAED,YAAY,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"ClassNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/ClassNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAqB,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEvF,UAAU,eAAgB,SAAQ,cAAc;IAC9C,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,UAAU,gBAAgB;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,qBAAa,SAAS;IACpB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,OAAO,CAAU;IAExC,MAAM,CAAC,QAAQ,CAAC,QAAQ,oCAAqC;IAC7D,MAAM,CAAC,QAAQ,CAAC,QAAQ,iFAAkF;IAE1G,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,gBAAqB,GAC7B,eAAe;IAmBlB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,iBAAiB,CACtB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,EAC3B,OAAO,GAAE,mBAAwB,GAChC,eAAe;IAuBlB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,EAAE;CAgBjD;AAED,YAAY,EAAE,eAAe,EAAE,CAAC"}

package/dist/core/nodes/ClassNode.js

@@ -1,10 +1,18 @@
 /**
  * ClassNode - contract for CLASS node
+ *
+ * Supports two creation modes:
+ * 1. createWithContext() - NEW: Uses ScopeContext + Location for semantic IDs
+ * 2. create() - LEGACY: Uses line-based IDs for backward compatibility
+ *
+ * Semantic ID format: {file}->{scope_path}->CLASS->{name}
+ * Example: src/models/User.js->global->CLASS->User
  */
+import { computeSemanticId } from '../SemanticId.js';
 export class ClassNode {
     static TYPE = 'CLASS';
     static REQUIRED = ['name', 'file', 'line'];
-    static OPTIONAL = ['column', 'exported', 'superClass', 'methods'];
+    static OPTIONAL = ['column', 'exported', 'superClass', 'methods', 'isInstantiationRef'];
     static create(name, file, line, column, options = {}) {
         if (!name)
             throw new Error('ClassNode.create: name is required');
@@ -21,7 +29,43 @@ export class ClassNode {
             column: column || 0,
             exported: options.exported || false,
             superClass: options.superClass,
-            methods: options.methods || []
+            methods: options.methods || [],
+            ...(options.isInstantiationRef !== undefined && { isInstantiationRef: options.isInstantiationRef })
+        };
+    }
+    /**
+     * Create CLASS node with semantic ID (NEW API)
+     *
+     * Uses ScopeContext from ScopeTracker for stable identifiers.
+     * Class names are unique within scope, so no discriminator needed.
+     *
+     * @param name - Class name
+     * @param context - Scope context from ScopeTracker.getContext()
+     * @param location - Source location { line, column }
+     * @param options - Optional class properties
+     * @returns ClassNodeRecord with semantic ID
+     */
+    static createWithContext(name, context, location, options = {}) {
+        // Validate required fields
+        if (!name)
+            throw new Error('ClassNode.createWithContext: name is required');
+        if (!context.file)
+            throw new Error('ClassNode.createWithContext: file is required');
+        if (location.line === undefined)
+            throw new Error('ClassNode.createWithContext: line is required');
+        // Compute semantic ID
+        const id = computeSemanticId(this.TYPE, name, context);
+        return {
+            id,
+            type: this.TYPE,
+            name,
+            file: context.file,
+            line: location.line,
+            column: location.column ?? 0,
+            exported: options.exported || false,
+            superClass: options.superClass,
+            methods: options.methods || [],
+            ...(options.isInstantiationRef !== undefined && { isInstantiationRef: options.isInstantiationRef })
         };
     }
     static validate(node) {

package/dist/core/nodes/DecoratorNode.d.ts

@@ -0,0 +1,42 @@
+/**
+ * DecoratorNode - contract for DECORATOR node
+ *
+ * Represents TypeScript/JavaScript decorators applied to
+ * classes, methods, properties, or parameters.
+ *
+ * ID format: {file}:DECORATOR:{name}:{line}:{column}
+ * Example: /src/services/UserService.ts:DECORATOR:Injectable:5:0
+ */
+import type { BaseNodeRecord } from '@grafema/types';
+type DecoratorTargetType = 'CLASS' | 'METHOD' | 'PROPERTY' | 'PARAMETER';
+interface DecoratorNodeRecord extends BaseNodeRecord {
+    type: 'DECORATOR';
+    column: number;
+    arguments: unknown[];
+    targetId: string;
+    targetType: DecoratorTargetType;
+}
+interface DecoratorNodeOptions {
+    arguments?: unknown[];
+}
+export declare class DecoratorNode {
+    static readonly TYPE: "DECORATOR";
+    static readonly REQUIRED: readonly ["name", "file", "line", "targetId", "targetType"];
+    static readonly OPTIONAL: readonly ["column", "arguments"];
+    /**
+     * Create DECORATOR node
+     *
+     * @param name - Decorator name
+     * @param file - File path
+     * @param line - Line number
+     * @param column - Column position
+     * @param targetId - ID of decorated element
+     * @param targetType - Type of decorated element
+     * @param options - Optional decorator properties
+     * @returns DecoratorNodeRecord
+     */
+    static create(name: string, file: string, line: number, column: number, targetId: string, targetType: DecoratorTargetType, options?: DecoratorNodeOptions): DecoratorNodeRecord;
+    static validate(node: DecoratorNodeRecord): string[];
+}
+export type { DecoratorNodeRecord, DecoratorTargetType };
+//# sourceMappingURL=DecoratorNode.d.ts.map

package/dist/core/nodes/DecoratorNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DecoratorNode.d.ts","sourceRoot":"","sources":["../../../src/core/nodes/DecoratorNode.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,KAAK,mBAAmB,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,WAAW,CAAC;AAEzE,UAAU,mBAAoB,SAAQ,cAAc;IAClD,IAAI,EAAE,WAAW,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,mBAAmB,CAAC;CACjC;AAED,UAAU,oBAAoB;IAC5B,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;CACvB;AAED,qBAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IAE5C,MAAM,CAAC,QAAQ,CAAC,QAAQ,8DAA+D;IACvF,MAAM,CAAC,QAAQ,CAAC,QAAQ,mCAAoC;IAE5D;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,MAAM,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,mBAAmB,EAC/B,OAAO,GAAE,oBAAyB,GACjC,mBAAmB;IAoBtB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,GAAG,MAAM,EAAE;CAgBrD;AAED,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,CAAC"}