sysmledgraph 0.7.0

package/dist/src/parser/sysml-mcp-client.js

@@ -0,0 +1,185 @@
+/**
+ * SysML MCP client: spawns sysml-v2-lsp MCP server and exposes tools as a callable API.
+ * Use this when you want to call parse, validate, getSymbols, etc. from code (e.g. tests or scripts).
+ *
+ * Requires sysml-v2-lsp as a dependency. Uses the same Content-Length framing as the MCP server.
+ */
+import { spawn } from 'child_process';
+import { createRequire } from 'module';
+import { resolve } from 'path';
+const require = createRequire(import.meta.url);
+/** Resolved path to mcpServer.js (from sysml-v2-lsp package). */
+export function getMcpServerPath() {
+    try {
+        const { mcpServerPath } = require('sysml-v2-lsp');
+        return mcpServerPath;
+    }
+    catch {
+        const fromCwd = resolve(process.cwd(), 'node_modules/sysml-v2-lsp/dist/server/mcpServer.js');
+        return fromCwd;
+    }
+}
+function sendMessage(proc, body) {
+    const buf = Buffer.from(body, 'utf8');
+    const header = `Content-Length: ${buf.length}\r\n\r\n`;
+    proc.stdin?.write(header + body, 'utf8');
+}
+function createMcpReader(proc) {
+    let buffer = '';
+    let contentLength = null;
+    let pending = null;
+    proc.stdout?.setEncoding('utf8');
+    proc.stdout?.on('data', (chunk) => {
+        buffer += chunk;
+        for (;;) {
+            if (contentLength === null) {
+                const idx = buffer.indexOf('\r\n\r\n');
+                if (idx === -1)
+                    break;
+                const header = buffer.slice(0, idx);
+                const m = header.match(/Content-Length:\s*(\d+)/i);
+                contentLength = m ? parseInt(m[1], 10) : 0;
+                buffer = buffer.slice(idx + 4);
+            }
+            if (contentLength !== null && buffer.length >= contentLength) {
+                const body = buffer.slice(0, contentLength);
+                buffer = buffer.slice(contentLength);
+                contentLength = null;
+                if (pending) {
+                    pending.resolve(body);
+                    pending = null;
+                }
+            }
+            else
+                break;
+        }
+    });
+    function readNext() {
+        return new Promise((resolve, reject) => {
+            pending = { resolve, reject };
+        });
+    }
+    function drain() {
+        buffer = '';
+        contentLength = null;
+        if (pending) {
+            pending.reject(new Error('drained'));
+            pending = null;
+        }
+    }
+    return { readNext, drain };
+}
+let id = 0;
+function nextId() {
+    return ++id;
+}
+/**
+ * Client that talks to sysml-v2-lsp MCP server over stdio.
+ * Call createSysmlMcpClient(), then use the returned methods, then close().
+ */
+export async function createSysmlMcpClient(options = {}) {
+    const serverPath = options.serverPath ?? getMcpServerPath();
+    const initTimeout = options.initTimeout ?? 20000;
+    const debug = options.debug ?? false;
+    // Match Cursor: run from project root; on Windows use cmd /c node <path> so Node runs the script (avoids "open with" for .js).
+    const isWin = process.platform === 'win32';
+    const proc = isWin
+        ? spawn('cmd', ['/c', process.execPath, serverPath], { stdio: ['pipe', 'pipe', 'pipe'], cwd: process.cwd() })
+        : spawn(process.execPath, [serverPath], { stdio: ['pipe', 'pipe', 'pipe'], cwd: process.cwd() });
+    if (debug) {
+        proc.stdout?.on('data', (chunk) => {
+            const s = typeof chunk === 'string' ? chunk : chunk.toString('utf8');
+            console.error('[mcp stdout]', s.length, 'bytes:', s.slice(0, 300));
+        });
+        proc.stderr?.on('data', (chunk) => {
+            console.error('[mcp stderr]', (typeof chunk === 'string' ? chunk : chunk.toString('utf8')).slice(0, 500));
+        });
+        proc.on('exit', (code, signal) => console.error('[mcp exit]', code, signal));
+        proc.on('error', (err) => console.error('[mcp error]', err.message));
+    }
+    if (!debug)
+        proc.stderr?.on('data', () => { });
+    const { readNext, drain } = createMcpReader(proc);
+    const reqId = nextId();
+    sendMessage(proc, JSON.stringify({
+        jsonrpc: '2.0',
+        id: reqId,
+        method: 'initialize',
+        params: {
+            protocolVersion: '2024-11-05',
+            capabilities: {},
+            clientInfo: { name: 'sysmledgraph-mcp-client', version: '0.1.0' },
+        },
+    }));
+    const initResponse = await Promise.race([
+        (async () => {
+            for (;;) {
+                const raw = await readNext();
+                const msg = JSON.parse(raw);
+                if (msg.id === reqId) {
+                    if (msg.error)
+                        throw new Error(msg.error.message);
+                    return msg.result;
+                }
+            }
+        })(),
+        new Promise((_, rej) => setTimeout(() => rej(new Error('initialize timeout')), initTimeout)),
+    ]);
+    if (!initResponse) {
+        proc.kill('SIGTERM');
+        throw new Error('initialize returned no result');
+    }
+    sendMessage(proc, JSON.stringify({ jsonrpc: '2.0', method: 'notifications/initialized' }));
+    await new Promise((r) => setTimeout(r, 200));
+    async function callTool(name, args) {
+        const uri = args.uri ?? 'file:///untitled.sysml';
+        const toolArgs = { ...args, uri };
+        const rid = nextId();
+        sendMessage(proc, JSON.stringify({
+            jsonrpc: '2.0',
+            id: rid,
+            method: 'tools/call',
+            params: { name, arguments: toolArgs },
+        }));
+        for (;;) {
+            const raw = await readNext();
+            const msg = JSON.parse(raw);
+            if (msg.id === rid) {
+                if (msg.error)
+                    throw new Error(msg.error.message);
+                const result = msg.result;
+                if (!result?.content?.length)
+                    return result;
+                const text = result.content[0].text;
+                if (typeof text !== 'string')
+                    return result;
+                try {
+                    return JSON.parse(text);
+                }
+                catch {
+                    return result;
+                }
+            }
+        }
+    }
+    const uriDefault = 'file:///untitled.sysml';
+    return {
+        parse: (code, uri = uriDefault) => callTool('parse', { code, uri }),
+        validate: (code, uri = uriDefault) => callTool('validate', { code, uri }),
+        getDiagnostics: (code, uri = uriDefault) => callTool('getDiagnostics', { code, uri }),
+        validateFile: (code, uri = uriDefault) => callTool('validateFile', { code, uri }),
+        getSymbols: (code, uri = uriDefault) => callTool('getSymbols', { code, uri }),
+        getDefinition: (name, code, uri = uriDefault) => callTool('getDefinition', { name, code, uri }),
+        getReferences: (name, code, uri = uriDefault) => callTool('getReferences', { name, code, uri }),
+        getHierarchy: (name, code, uri = uriDefault) => callTool('getHierarchy', { name, code, uri }),
+        getModelSummary: (code, uri = uriDefault) => callTool('getModelSummary', { code, uri }),
+        getComplexity: (code, uri = uriDefault) => callTool('getComplexity', { code, uri }),
+        preview: (code, uri = uriDefault) => callTool('preview', { code, uri }),
+        callTool,
+        close: () => {
+            drain();
+            proc.kill('SIGTERM');
+        },
+    };
+}
+//# sourceMappingURL=sysml-mcp-client.js.map

package/dist/src/parser/sysml-mcp-client.js.map

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

package/dist/src/storage/clean.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Clean: delete index for path or all. Phase 2 step 9. R8: on failure report, graph unchanged.
+ * Uses merged graph: single path = delete nodes for that root; all = delete DB file.
+ */
+export interface CleanResult {
+    ok: boolean;
+    removed: string[];
+    error?: string;
+}
+/**
+ * Remove index for a single path or all paths. Updates registry.
+ * Single path: delete nodes for that root from merged graph. All: delete merged DB file.
+ */
+export declare function cleanIndex(path?: string): Promise<CleanResult>;
+//# sourceMappingURL=clean.d.ts.map

package/dist/src/storage/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../../src/storage/clean.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA2BpE"}

package/dist/src/storage/clean.js

@@ -0,0 +1,44 @@
+/**
+ * Clean: delete index for path or all. Phase 2 step 9. R8: on failure report, graph unchanged.
+ * Uses merged graph: single path = delete nodes for that root; all = delete DB file.
+ */
+import { rm } from 'fs/promises';
+import { getMergedDbPath } from './location.js';
+import { listIndexedPaths } from './list.js';
+import { removeFromRegistry, clearRegistry } from './registry.js';
+import { getCachedOrOpenGraphStore, closeGraphStoreCache } from '../graph/graph-store.js';
+/**
+ * Remove index for a single path or all paths. Updates registry.
+ * Single path: delete nodes for that root from merged graph. All: delete merged DB file.
+ */
+export async function cleanIndex(path) {
+    const removed = [];
+    try {
+        if (path !== undefined && path !== '') {
+            const mergedPath = getMergedDbPath();
+            const store = await getCachedOrOpenGraphStore(mergedPath);
+            if (store.deleteNodesForRoot) {
+                await store.deleteNodesForRoot(path);
+            }
+            await removeFromRegistry(path);
+            removed.push(path);
+        }
+        else {
+            const paths = await listIndexedPaths();
+            const mergedPath = getMergedDbPath();
+            await closeGraphStoreCache(mergedPath);
+            await rm(mergedPath, { recursive: true, force: true });
+            await clearRegistry();
+            removed.push(...paths);
+        }
+        return { ok: true, removed };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            removed,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+//# sourceMappingURL=clean.js.map

package/dist/src/storage/clean.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.js","sourceRoot":"","sources":["../../../src/storage/clean.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAQ1F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAa;IAC5C,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;YACtC,MAAM,UAAU,GAAG,eAAe,EAAE,CAAC;YACrC,MAAM,KAAK,GAAG,MAAM,yBAAyB,CAAC,UAAU,CAAC,CAAC;YAC1D,IAAI,KAAK,CAAC,kBAAkB,EAAE,CAAC;gBAC7B,MAAM,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACvC,CAAC;YACD,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,MAAM,KAAK,GAAG,MAAM,gBAAgB,EAAE,CAAC;YACvC,MAAM,UAAU,GAAG,eAAe,EAAE,CAAC;YACrC,MAAM,oBAAoB,CAAC,UAAU,CAAC,CAAC;YACvC,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACvD,MAAM,aAAa,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,OAAO;YACP,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/src/storage/list.d.ts

@@ -0,0 +1,9 @@
+/**
+ * List indexed path(s). Phase 2 step 9.
+ * Reads registry (canonical list of indexed root paths).
+ */
+/**
+ * List all indexed root paths from registry.
+ */
+export declare function listIndexedPaths(): Promise<string[]>;
+//# sourceMappingURL=list.d.ts.map

package/dist/src/storage/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/storage/list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAE1D"}

package/dist/src/storage/list.js

@@ -0,0 +1,12 @@
+/**
+ * List indexed path(s). Phase 2 step 9.
+ * Reads registry (canonical list of indexed root paths).
+ */
+import { readRegistry } from './registry.js';
+/**
+ * List all indexed root paths from registry.
+ */
+export async function listIndexedPaths() {
+    return readRegistry();
+}
+//# sourceMappingURL=list.js.map

package/dist/src/storage/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/storage/list.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,OAAO,YAAY,EAAE,CAAC;AACxB,CAAC"}

package/dist/src/storage/location.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Storage location: resolve DB path (per-path or global registry).
+ * Phase 2 step 7. Decision documented in README.
+ */
+/**
+ * Set storage root (e.g. from env SYSMEDGRAPH_STORAGE_ROOT or config).
+ */
+export declare function setStorageRoot(root: string): void;
+/**
+ * Get current storage root.
+ */
+export declare function getStorageRoot(): string;
+/**
+ * Path of the single merged graph DB. All indexed paths share this DB; nodes carry a path property.
+ */
+export declare function getMergedDbPath(): string;
+/**
+ * Resolve DB path for an indexed root path.
+ * Strategy: one merged graph (all paths in one DB); path is stored on Node.path. Caller ensures path is absolute/normalized.
+ */
+export declare function getDbPathForIndexedPath(_indexedPath: string): string;
+//# sourceMappingURL=location.d.ts.map

package/dist/src/storage/location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.d.ts","sourceRoot":"","sources":["../../../src/storage/location.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAKD;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAEpE"}

package/dist/src/storage/location.js

@@ -0,0 +1,36 @@
+/**
+ * Storage location: resolve DB path (per-path or global registry).
+ * Phase 2 step 7. Decision documented in README.
+ */
+import { join } from 'path';
+import { homedir } from 'os';
+const DEFAULT_STORAGE_ROOT = join(homedir(), '.sysmledgraph');
+let storageRoot = DEFAULT_STORAGE_ROOT;
+/**
+ * Set storage root (e.g. from env SYSMEDGRAPH_STORAGE_ROOT or config).
+ */
+export function setStorageRoot(root) {
+    storageRoot = root;
+}
+/**
+ * Get current storage root.
+ */
+export function getStorageRoot() {
+    return storageRoot;
+}
+/** Single merged graph DB path (plan step 8: one merged graph with path on Document nodes). */
+const MERGED_DB_FILENAME = 'graph.kuzu';
+/**
+ * Path of the single merged graph DB. All indexed paths share this DB; nodes carry a path property.
+ */
+export function getMergedDbPath() {
+    return join(storageRoot, 'db', MERGED_DB_FILENAME);
+}
+/**
+ * Resolve DB path for an indexed root path.
+ * Strategy: one merged graph (all paths in one DB); path is stored on Node.path. Caller ensures path is absolute/normalized.
+ */
+export function getDbPathForIndexedPath(_indexedPath) {
+    return getMergedDbPath();
+}
+//# sourceMappingURL=location.js.map

package/dist/src/storage/location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.js","sourceRoot":"","sources":["../../../src/storage/location.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAE7B,MAAM,oBAAoB,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,eAAe,CAAC,CAAC;AAE9D,IAAI,WAAW,GAAW,oBAAoB,CAAC;AAE/C;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,+FAA+F;AAC/F,MAAM,kBAAkB,GAAG,YAAY,CAAC;AAExC;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,kBAAkB,CAAC,CAAC;AACrD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,YAAoB;IAC1D,OAAO,eAAe,EAAE,CAAC;AAC3B,CAAC"}

package/dist/src/storage/registry.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Registry of indexed paths and last-indexed time. Used for list/clean.
+ */
+export interface RegistryData {
+    paths: string[];
+    /** path -> ISO date string when last indexed */
+    indexedAt?: Record<string, string>;
+}
+export declare function readRegistry(): Promise<string[]>;
+export declare function readRegistryFull(): Promise<RegistryData>;
+export declare function addToRegistry(path: string, indexedAt?: string): Promise<void>;
+export declare function removeFromRegistry(path: string): Promise<void>;
+export declare function clearRegistry(): Promise<void>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/storage/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/storage/registry.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAMD,wBAAsB,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAGtD;AAED,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,YAAY,CAAC,CAW9D;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBnF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOpE;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAGnD"}

package/dist/src/storage/registry.js

@@ -0,0 +1,59 @@
+/**
+ * Registry of indexed paths and last-indexed time. Used for list/clean.
+ */
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { join } from 'path';
+import { getStorageRoot } from './location.js';
+const REGISTRY_FILENAME = 'registry.json';
+async function registryPath() {
+    return join(getStorageRoot(), REGISTRY_FILENAME);
+}
+export async function readRegistry() {
+    const data = await readRegistryFull();
+    return data.paths;
+}
+export async function readRegistryFull() {
+    try {
+        const raw = await readFile(await registryPath(), 'utf-8');
+        const data = JSON.parse(raw);
+        return {
+            paths: Array.isArray(data.paths) ? data.paths : [],
+            indexedAt: data.indexedAt && typeof data.indexedAt === 'object' ? data.indexedAt : {},
+        };
+    }
+    catch {
+        return { paths: [], indexedAt: {} };
+    }
+}
+export async function addToRegistry(path, indexedAt) {
+    const data = await readRegistryFull();
+    if (data.paths.includes(path)) {
+        if (indexedAt != null) {
+            data.indexedAt = data.indexedAt ?? {};
+            data.indexedAt[path] = indexedAt;
+            await mkdir(getStorageRoot(), { recursive: true });
+            await writeFile(await registryPath(), JSON.stringify(data, null, 0), 'utf-8');
+        }
+        return;
+    }
+    data.paths.push(path);
+    if (indexedAt != null) {
+        data.indexedAt = data.indexedAt ?? {};
+        data.indexedAt[path] = indexedAt;
+    }
+    await mkdir(getStorageRoot(), { recursive: true });
+    await writeFile(await registryPath(), JSON.stringify(data, null, 0), 'utf-8');
+}
+export async function removeFromRegistry(path) {
+    const data = await readRegistryFull();
+    const paths = data.paths.filter((p) => p !== path);
+    const indexedAt = { ...(data.indexedAt ?? {}) };
+    delete indexedAt[path];
+    await mkdir(getStorageRoot(), { recursive: true });
+    await writeFile(await registryPath(), JSON.stringify({ paths, indexedAt }, null, 0), 'utf-8');
+}
+export async function clearRegistry() {
+    await mkdir(getStorageRoot(), { recursive: true });
+    await writeFile(await registryPath(), JSON.stringify({ paths: [], indexedAt: {} }, null, 0), 'utf-8');
+}
+//# sourceMappingURL=registry.js.map

package/dist/src/storage/registry.js.map

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

package/dist/src/symbol-to-graph/mapping.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Symbol → graph mapping: LSP symbol kinds to node labels and edge types.
+ * Single place to avoid schema drift. Phase 1 step 5, Phase 2.
+ * See GITNEXUS_FEATURES.md and deploy model GraphStore doc.
+ */
+import type { NodeLabel, EdgeType } from '../types.js';
+/**
+ * Map LSP DocumentSymbol detail (SysML metaclass name from the LSP) or kind string to graph node label.
+ * Covers SysML v2 metaclasses; also MCP-style kinds (e.g. "package", "requirement def"). Unmapped kinds are skipped.
+ */
+export declare function symbolKindToNodeLabel(kind: string): NodeLabel | undefined;
+export declare function lspSymbolKindToNodeLabel(kind: number): NodeLabel | undefined;
+/**
+ * Map relation semantics to graph edge type.
+ */
+export declare function relationToEdgeType(relation: string): EdgeType | undefined;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/src/symbol-to-graph/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../../src/symbol-to-graph/mapping.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAyDzE;AAcD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE5E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAezE"}

package/dist/src/symbol-to-graph/mapping.js

@@ -0,0 +1,102 @@
+/**
+ * Symbol → graph mapping: LSP symbol kinds to node labels and edge types.
+ * Single place to avoid schema drift. Phase 1 step 5, Phase 2.
+ * See GITNEXUS_FEATURES.md and deploy model GraphStore doc.
+ */
+/**
+ * Map LSP DocumentSymbol detail (SysML metaclass name from the LSP) or kind string to graph node label.
+ * Covers SysML v2 metaclasses; also MCP-style kinds (e.g. "package", "requirement def"). Unmapped kinds are skipped.
+ */
+export function symbolKindToNodeLabel(kind) {
+    const map = {
+        Package: 'Package',
+        package: 'Package',
+        PartDefinition: 'PartDef',
+        'Part Definition': 'PartDef',
+        'part definition': 'PartDef',
+        'part def': 'PartDef',
+        PartUsage: 'PartUsage',
+        'part usage': 'PartUsage',
+        ConnectionDefinition: 'ConnectionDef',
+        'connection def': 'ConnectionDef',
+        ConnectionUsage: 'ConnectionUsage',
+        'connection usage': 'ConnectionUsage',
+        PortDefinition: 'PortDef',
+        'port def': 'PortDef',
+        PortUsage: 'Port',
+        'port usage': 'Port',
+        RequirementDefinition: 'RequirementDef',
+        'Requirement Definition': 'RequirementDef',
+        'requirement definition': 'RequirementDef',
+        'requirement def': 'RequirementDef',
+        RequirementUsage: 'RequirementDef',
+        'requirement usage': 'RequirementDef',
+        Block: 'Block',
+        block: 'Block',
+        ValueType: 'ValueType',
+        'value type': 'ValueType',
+        ActionDefinition: 'Action',
+        'action def': 'Action',
+        ActionUsage: 'Action',
+        'action usage': 'Action',
+        StateDefinition: 'StateMachine',
+        'state def': 'StateMachine',
+        StateUsage: 'StateMachine',
+        'state usage': 'StateMachine',
+        AttributeDefinition: 'ValueType',
+        'attribute def': 'ValueType',
+        AttributeUsage: 'ValueType',
+        'attribute usage': 'ValueType',
+        InterfaceDefinition: 'Block',
+        'interface def': 'Block',
+        InterfaceUsage: 'Block',
+        'interface usage': 'Block',
+        ItemDefinition: 'Block',
+        'item def': 'Block',
+        ItemUsage: 'Block',
+        'item usage': 'Block',
+        OccurrenceDefinition: 'PartDef',
+        'occurrence def': 'PartDef',
+        OccurrenceUsage: 'PartUsage',
+        'occurrence usage': 'PartUsage',
+    };
+    const exact = map[kind];
+    if (exact)
+        return exact;
+    const normalized = kind?.trim().toLowerCase().replace(/\s+/g, ' ');
+    return map[normalized] ?? map[kind?.trim() ?? ''];
+}
+/** LSP SymbolKind enum (number). Used when DocumentSymbol.detail is missing. */
+const LSP_KIND_TO_LABEL = {
+    2: 'Package', // Namespace
+    4: 'Package', // Package
+    5: 'PartDef', // Class
+    6: 'Action', // Method
+    7: 'ValueType', // Property
+    8: 'ValueType', // Field
+    10: 'Block', // Enum
+    11: 'Block', // Interface
+};
+export function lspSymbolKindToNodeLabel(kind) {
+    return LSP_KIND_TO_LABEL[kind];
+}
+/**
+ * Map relation semantics to graph edge type.
+ */
+export function relationToEdgeType(relation) {
+    const map = {
+        inDocument: 'IN_DOCUMENT',
+        inPackage: 'IN_PACKAGE',
+        parent: 'PARENT',
+        types: 'TYPES',
+        references: 'REFERENCES',
+        imports: 'IMPORTS',
+        satisfy: 'SATISFY',
+        derive: 'DERIVE',
+        verify: 'VERIFY',
+        binding: 'BINDING',
+        connectionEnd: 'CONNECTION_END',
+    };
+    return map[relation];
+}
+//# sourceMappingURL=mapping.js.map

package/dist/src/symbol-to-graph/mapping.js.map

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

package/dist/src/types.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Shared types for sysmledgraph.
+ * Aligns with deploy model and GITNEXUS_FEATURES schema.
+ */
+/** Node labels in the graph (SysML-native grouping). */
+export declare const NODE_LABELS: readonly ["Document", "Package", "PartDef", "PartUsage", "ConnectionDef", "ConnectionUsage", "PortDef", "Port", "RequirementDef", "Block", "ValueType", "Action", "StateMachine"];
+export type NodeLabel = (typeof NODE_LABELS)[number];
+/** Edge types in the graph. */
+export declare const EDGE_TYPES: readonly ["IN_DOCUMENT", "IN_PACKAGE", "PARENT", "TYPES", "REFERENCES", "IMPORTS", "SATISFY", "DERIVE", "VERIFY", "BINDING", "CONNECTION_END"];
+export type EdgeType = (typeof EDGE_TYPES)[number];
+/** Document node properties. */
+export interface DocumentProps {
+    path: string;
+    indexedAt?: string;
+}
+/** Symbol node properties (common). */
+export interface SymbolProps {
+    name: string;
+    qualifiedName?: string;
+    path: string;
+    [key: string]: unknown;
+}
+/** A relation from parser/symbol layer for graph edges. */
+export interface SymbolRelation {
+    from: string;
+    to: string;
+    type: EdgeType;
+}
+/** Normalized symbol shape for graph (from parser). */
+export interface NormalizedSymbol {
+    label: NodeLabel;
+    props: SymbolProps;
+    relations: SymbolRelation[];
+}
+/** Config file at a path (e.g. config.yaml). */
+export interface ModelConfig {
+    model_dir?: string;
+    model_files?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wDAAwD;AACxD,eAAO,MAAM,WAAW,mLAcd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,+BAA+B;AAC/B,eAAO,MAAM,UAAU,gJAYb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,gCAAgC;AAChC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,uCAAuC;AACvC,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,2DAA2D;AAC3D,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;CAChB;AAED,uDAAuD;AACvD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB"}