sysmledgraph 0.7.0

package/dist/src/types.js

@@ -0,0 +1,35 @@
+/**
+ * Shared types for sysmledgraph.
+ * Aligns with deploy model and GITNEXUS_FEATURES schema.
+ */
+/** Node labels in the graph (SysML-native grouping). */
+export const NODE_LABELS = [
+    'Document',
+    'Package',
+    'PartDef',
+    'PartUsage',
+    'ConnectionDef',
+    'ConnectionUsage',
+    'PortDef',
+    'Port',
+    'RequirementDef',
+    'Block',
+    'ValueType',
+    'Action',
+    'StateMachine',
+];
+/** Edge types in the graph. */
+export const EDGE_TYPES = [
+    'IN_DOCUMENT',
+    'IN_PACKAGE',
+    'PARENT',
+    'TYPES',
+    'REFERENCES',
+    'IMPORTS',
+    'SATISFY',
+    'DERIVE',
+    'VERIFY',
+    'BINDING',
+    'CONNECTION_END',
+];
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,UAAU;IACV,SAAS;IACT,SAAS;IACT,WAAW;IACX,eAAe;IACf,iBAAiB;IACjB,SAAS;IACT,MAAM;IACN,gBAAgB;IAChB,OAAO;IACP,WAAW;IACX,QAAQ;IACR,cAAc;CACN,CAAC;AAIX,+BAA+B;AAC/B,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,aAAa;IACb,YAAY;IACZ,QAAQ;IACR,OAAO;IACP,YAAY;IACZ,SAAS;IACT,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,gBAAgB;CACR,CAAC"}

package/dist/src/worker/client.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Client for the graph worker. Spawns the worker process, sends init, then request(method, params) for each call.
+ * Only one process owns the DB; this process just sends commands and receives results.
+ */
+/** When true, MCP and CLI should use the worker for all graph operations. */
+export declare function useWorker(): boolean;
+/**
+ * Start the worker with the given storage root. Idempotent: if already started with same root, does nothing.
+ * Call from MCP server or CLI after setStorageRoot has been set (so getStorageRoot() is correct).
+ */
+export declare function startWorker(storageRoot: string): Promise<void>;
+/**
+ * Send a request to the worker and return the result. startWorker(storageRoot) must have been called first.
+ */
+export declare function request<T = unknown>(method: string, params?: Record<string, unknown>): Promise<T>;
+/**
+ * Close the worker (close stdin so it exits). Call when the app is done (e.g. CLI after one command).
+ */
+export declare function closeWorker(): void;
+export declare function isWorkerRunning(): boolean;
+//# sourceMappingURL=client.d.ts.map

package/dist/src/worker/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/worker/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,6EAA6E;AAC7E,wBAAgB,SAAS,IAAI,OAAO,CAEnC;AAcD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDpE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUjG;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAWlC;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}

package/dist/src/worker/client.js

@@ -0,0 +1,126 @@
+/**
+ * Client for the graph worker. Spawns the worker process, sends init, then request(method, params) for each call.
+ * Only one process owns the DB; this process just sends commands and receives results.
+ */
+import { spawn } from 'child_process';
+import { createInterface } from 'readline';
+import { dirname, join } from 'path';
+import { fileURLToPath } from 'url';
+import { existsSync } from 'fs';
+import { isWorkerResponseErr } from './protocol.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** When true, MCP and CLI should use the worker for all graph operations. */
+export function useWorker() {
+    return process.env.SYSMLEDGRAPH_USE_WORKER === '1';
+}
+let nextId = 1;
+const pending = new Map();
+let workerProcess = null;
+let rl = null;
+function getWorkerPath() {
+    const nextToClient = join(__dirname, 'graph-worker.js');
+    if (existsSync(nextToClient))
+        return nextToClient;
+    return join(process.cwd(), 'dist', 'src', 'worker', 'graph-worker.js');
+}
+/**
+ * Start the worker with the given storage root. Idempotent: if already started with same root, does nothing.
+ * Call from MCP server or CLI after setStorageRoot has been set (so getStorageRoot() is correct).
+ */
+export async function startWorker(storageRoot) {
+    if (workerProcess != null)
+        return;
+    const workerJs = getWorkerPath();
+    const child = spawn(process.execPath, [workerJs], {
+        stdio: ['pipe', 'pipe', 'inherit'],
+        env: { ...process.env },
+    });
+    workerProcess = child;
+    rl = createInterface({ input: child.stdout, terminal: false });
+    rl.on('line', (line) => {
+        try {
+            const res = JSON.parse(line);
+            const id = res.id;
+            const p = pending.get(id);
+            if (p) {
+                pending.delete(id);
+                if (isWorkerResponseErr(res))
+                    p.reject(new Error(res.error));
+                else
+                    p.resolve(res.result);
+            }
+        }
+        catch {
+            // ignore malformed lines
+        }
+    });
+    child.on('error', (err) => {
+        for (const [, p] of pending)
+            p.reject(err);
+        pending.clear();
+    });
+    child.on('exit', (code) => {
+        workerProcess = null;
+        rl = null;
+        if (code != null && code !== 0) {
+            for (const [, p] of pending)
+                p.reject(new Error(`Worker exited with code ${code}`));
+            pending.clear();
+        }
+    });
+    // Send init
+    const initReq = { id: 0, method: 'init', params: { storageRoot } };
+    child.stdin.write(JSON.stringify(initReq) + '\n');
+    await new Promise((resolve, reject) => {
+        const onLine = (line) => {
+            try {
+                const res = JSON.parse(line);
+                if (res.id === 0) {
+                    rl.off('line', onLine);
+                    if (isWorkerResponseErr(res))
+                        reject(new Error(res.error));
+                    else
+                        resolve();
+                }
+            }
+            catch {
+                // continue
+            }
+        };
+        rl.on('line', onLine);
+    });
+}
+/**
+ * Send a request to the worker and return the result. startWorker(storageRoot) must have been called first.
+ */
+export function request(method, params) {
+    if (workerProcess == null || workerProcess.stdin == null) {
+        return Promise.reject(new Error('Worker not started; call startWorker(storageRoot) first'));
+    }
+    const id = nextId++;
+    const req = { id, method, params };
+    return new Promise((resolve, reject) => {
+        pending.set(id, { resolve: resolve, reject });
+        workerProcess.stdin.write(JSON.stringify(req) + '\n');
+    });
+}
+/**
+ * Close the worker (close stdin so it exits). Call when the app is done (e.g. CLI after one command).
+ */
+export function closeWorker() {
+    if (workerProcess != null && workerProcess.stdin != null) {
+        workerProcess.stdin.end();
+        workerProcess = null;
+    }
+    if (rl != null) {
+        rl.close();
+        rl = null;
+    }
+    for (const [, p] of pending)
+        p.reject(new Error('Worker closed'));
+    pending.clear();
+}
+export function isWorkerRunning() {
+    return workerProcess != null;
+}
+//# sourceMappingURL=client.js.map

package/dist/src/worker/client.js.map

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

package/dist/src/worker/gateway.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Graph gateway: when SYSMLEDGRAPH_USE_WORKER=1, all graph operations go through the worker; otherwise use in-process handlers.
+ * MCP server and CLI call these functions instead of the handlers directly.
+ */
+export declare function listIndexed(): Promise<{
+    ok: boolean;
+    paths?: string[];
+    error?: string;
+}>;
+export declare function index(args: {
+    path?: string;
+    paths?: string[];
+}): Promise<{
+    ok: boolean;
+    filesProcessed?: number;
+    error?: string;
+}>;
+export declare function clean(args: {
+    path?: string;
+}): Promise<{
+    ok: boolean;
+    removed?: string[];
+    error?: string;
+}>;
+export declare function cypher(args: {
+    query: string;
+}): Promise<{
+    ok: boolean;
+    rows?: unknown[];
+    error?: string;
+}>;
+export declare function query(args: {
+    query: string;
+    kind?: string;
+}): Promise<{
+    ok: boolean;
+    nodes?: unknown[];
+    error?: string;
+}>;
+export declare function context(args: {
+    name: string;
+}): Promise<{
+    ok: boolean;
+    node?: unknown;
+    edges?: unknown[];
+    error?: string;
+}>;
+export declare function impact(args: {
+    target: string;
+    direction?: 'upstream' | 'downstream';
+}): Promise<{
+    ok: boolean;
+    nodes?: unknown[];
+    error?: string;
+}>;
+export declare function rename(args: {
+    symbol: string;
+    newName: string;
+    dry_run?: boolean;
+}): Promise<{
+    ok: boolean;
+    preview?: {
+        path: string;
+        count: number;
+    }[];
+    message?: string;
+    error?: string;
+}>;
+export declare function generateMap(args?: {
+    output_path?: string;
+}): Promise<{
+    ok: boolean;
+    markdown?: string;
+    error?: string;
+}>;
+/** Context resource content (for MCP resource). When using worker, fetches from worker. */
+export declare function getContextContent(path?: string): Promise<string>;
+export { useWorker, closeWorker } from './client.js';
+//# sourceMappingURL=gateway.d.ts.map

package/dist/src/worker/gateway.d.ts.map

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

package/dist/src/worker/gateway.js

@@ -0,0 +1,93 @@
+/**
+ * Graph gateway: when SYSMLEDGRAPH_USE_WORKER=1, all graph operations go through the worker; otherwise use in-process handlers.
+ * MCP server and CLI call these functions instead of the handlers directly.
+ */
+import { getStorageRoot } from '../storage/location.js';
+import { startWorker, request, useWorker } from './client.js';
+import { handleListIndexed } from '../mcp/tools/list-indexed.js';
+import { handleIndexDbGraph } from '../mcp/tools/index-db-graph.js';
+import { handleCleanIndex } from '../mcp/tools/clean-index.js';
+import { handleCypher } from '../mcp/tools/cypher.js';
+import { handleQuery } from '../mcp/tools/query.js';
+import { handleContext } from '../mcp/tools/context.js';
+import { handleImpact } from '../mcp/tools/impact.js';
+import { handleRename } from '../mcp/tools/rename.js';
+import { handleGenerateMap } from '../mcp/tools/generate-map.js';
+import { getContextContent as getContextContentLocal } from '../mcp/resources/context.js';
+async function ensureWorker() {
+    await startWorker(getStorageRoot());
+}
+export async function listIndexed() {
+    if (useWorker()) {
+        await ensureWorker();
+        return request('list_indexed');
+    }
+    return handleListIndexed();
+}
+export async function index(args) {
+    if (useWorker()) {
+        await ensureWorker();
+        return request('index', args);
+    }
+    return handleIndexDbGraph(args);
+}
+export async function clean(args) {
+    if (useWorker()) {
+        await ensureWorker();
+        return request('clean', args);
+    }
+    return handleCleanIndex(args);
+}
+export async function cypher(args) {
+    if (useWorker()) {
+        await ensureWorker();
+        return request('cypher', args);
+    }
+    return handleCypher(args);
+}
+export async function query(args) {
+    if (useWorker()) {
+        await ensureWorker();
+        return request('query', args);
+    }
+    return handleQuery(args);
+}
+export async function context(args) {
+    if (useWorker()) {
+        await ensureWorker();
+        return request('context', args);
+    }
+    return handleContext(args);
+}
+export async function impact(args) {
+    if (useWorker()) {
+        await ensureWorker();
+        return request('impact', args);
+    }
+    return handleImpact(args);
+}
+export async function rename(args) {
+    if (useWorker()) {
+        await ensureWorker();
+        return request('rename', args);
+    }
+    return handleRename(args);
+}
+export async function generateMap(args) {
+    if (useWorker()) {
+        await ensureWorker();
+        return request('generateMap', args ?? {});
+    }
+    return handleGenerateMap(args ?? {});
+}
+/** Context resource content (for MCP resource). When using worker, fetches from worker. */
+export async function getContextContent(path) {
+    if (useWorker()) {
+        await ensureWorker();
+        const res = await request('getContextContent', { path });
+        return res?.content ?? '';
+    }
+    return getContextContentLocal(path);
+}
+export { useWorker, closeWorker } from './client.js';
+//# sourceMappingURL=gateway.js.map

package/dist/src/worker/gateway.js.map

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

package/dist/src/worker/graph-worker.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Graph worker: single process that owns the Kuzu DB. Listens for NDJSON commands on stdin, writes NDJSON responses to stdout.
+ * Run as: node dist/worker/graph-worker.js
+ * First message must be init with params.storageRoot. Then any method supported by the handlers.
+ */
+export {};
+//# sourceMappingURL=graph-worker.d.ts.map

package/dist/src/worker/graph-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-worker.d.ts","sourceRoot":"","sources":["../../../src/worker/graph-worker.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/worker/graph-worker.js

@@ -0,0 +1,91 @@
+/**
+ * Graph worker: single process that owns the Kuzu DB. Listens for NDJSON commands on stdin, writes NDJSON responses to stdout.
+ * Run as: node dist/worker/graph-worker.js
+ * First message must be init with params.storageRoot. Then any method supported by the handlers.
+ */
+import { createInterface } from 'readline';
+import { setStorageRoot } from '../storage/location.js';
+import { listIndexedPaths } from '../storage/list.js';
+import { handleListIndexed } from '../mcp/tools/list-indexed.js';
+import { handleIndexDbGraph } from '../mcp/tools/index-db-graph.js';
+import { handleCleanIndex } from '../mcp/tools/clean-index.js';
+import { handleCypher } from '../mcp/tools/cypher.js';
+import { handleQuery } from '../mcp/tools/query.js';
+import { handleContext } from '../mcp/tools/context.js';
+import { handleImpact } from '../mcp/tools/impact.js';
+import { handleRename } from '../mcp/tools/rename.js';
+import { handleGenerateMap } from '../mcp/tools/generate-map.js';
+import { getContextContent } from '../mcp/resources/context.js';
+let initialized = false;
+function respond(obj) {
+    process.stdout.write(JSON.stringify(obj) + '\n');
+}
+async function dispatch(method, params) {
+    const p = params ?? {};
+    switch (method) {
+        case 'listIndexedPaths': {
+            const paths = await listIndexedPaths();
+            return { paths };
+        }
+        case 'index':
+            return handleIndexDbGraph(p);
+        case 'clean':
+            return handleCleanIndex(p);
+        case 'cypher':
+            return handleCypher(p);
+        case 'query':
+            return handleQuery(p);
+        case 'context':
+            return handleContext(p);
+        case 'impact':
+            return handleImpact(p);
+        case 'rename':
+            return handleRename(p);
+        case 'generateMap':
+            return handleGenerateMap(p);
+        case 'list_indexed':
+            return handleListIndexed();
+        case 'getContextContent': {
+            const text = await getContextContent(p.path);
+            return { content: text };
+        }
+        default:
+            throw new Error(`Unknown method: ${method}`);
+    }
+}
+function run() {
+    const rl = createInterface({ input: process.stdin, terminal: false });
+    rl.on('line', async (line) => {
+        let req;
+        try {
+            req = JSON.parse(line);
+        }
+        catch {
+            respond({ id: 0, error: 'Invalid JSON' });
+            return;
+        }
+        const id = typeof req.id === 'number' ? req.id : 0;
+        if (req.method === 'init') {
+            const root = req.params?.storageRoot ?? '';
+            if (root)
+                setStorageRoot(root);
+            initialized = true;
+            respond({ id, result: {} });
+            return;
+        }
+        if (!initialized) {
+            respond({ id, error: 'Not initialized; send init first' });
+            return;
+        }
+        try {
+            const result = await dispatch(req.method, req.params);
+            respond({ id, result });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            respond({ id, error: msg });
+        }
+    });
+}
+run();
+//# sourceMappingURL=graph-worker.js.map

package/dist/src/worker/graph-worker.js.map

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

package/dist/src/worker/protocol.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Worker protocol: NDJSON over stdio.
+ * Request: { id, method, params? }
+ * Response: { id, result? } | { id, error? }
+ */
+export interface WorkerRequest {
+    id?: number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface WorkerResponseOk {
+    id: number;
+    result: unknown;
+}
+export interface WorkerResponseErr {
+    id: number;
+    error: string;
+}
+export type WorkerResponse = WorkerResponseOk | WorkerResponseErr;
+export declare function isWorkerResponseErr(r: WorkerResponse): r is WorkerResponseErr;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/src/worker/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/worker/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,iBAAiB,CAAC;AAElE,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,cAAc,GAAG,CAAC,IAAI,iBAAiB,CAE7E"}

package/dist/src/worker/protocol.js

@@ -0,0 +1,9 @@
+/**
+ * Worker protocol: NDJSON over stdio.
+ * Request: { id, method, params? }
+ * Response: { id, result? } | { id, error? }
+ */
+export function isWorkerResponseErr(r) {
+    return 'error' in r && typeof r.error === 'string';
+}
+//# sourceMappingURL=protocol.js.map

package/dist/src/worker/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../../src/worker/protocol.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,MAAM,UAAU,mBAAmB,CAAC,CAAiB;IACnD,OAAO,OAAO,IAAI,CAAC,IAAI,OAAQ,CAAuB,CAAC,KAAK,KAAK,QAAQ,CAAC;AAC5E,CAAC"}

package/docs/INSTALL.md

@@ -0,0 +1,16 @@
+# Install
+
+## Quick start
+
+1. **Root:** `npm install` then `npm run build`.
+2. **LSP (for indexing):** The canonical LSP for this repo is in **`lsp/`**. Run **`npm run setup-lsp`** (or `cd lsp && npm install`) so the indexer can use it. No need to set **`SYSMLLSP_SERVER_PATH`** when using this default.
+3. **Index:** `npx sysmledgraph analyze <path>` or use the MCP tool **indexDbGraph** after enabling the sysmledgraph MCP in Cursor (see docs/MCP_SERVER_FOR_CURSOR.md).
+
+## LSP
+
+- **Source:** [sysml-v2-lsp](https://www.npmjs.com/package/sysml-v2-lsp) (npm). The only copy used by sysmledgraph for indexing is in **`lsp/`** (see docs/PLAN_INDEPENDENT_LSP.md).
+- **Setup:** `npm run setup-lsp` installs it in `lsp/` with `--ignore-scripts` (recommended on Windows). If you prefer a manual install: `cd lsp && npm install`.
+
+## Kuzu
+
+If `npm install` fails or you use `--ignore-scripts`, build Kuzu manually: `node node_modules/kuzu/install.js`. See docs/INSTALL_NOTES.md if present.