sysmledgraph 0.7.0

package/README.md

@@ -0,0 +1,71 @@
+# sysmledgraph
+
+Path-only SysML indexer: builds a knowledge graph from `.sysml` files and exposes it via **MCP** (for Cursor AI) and **CLI**. The LSP used for indexing lives in **`lsp/`** and is used only by this repo.
+
+## Requirements
+
+- **Node.js 20+**
+- **Kuzu** (built via `npm install` or `node node_modules/kuzu/install.js` if you use `--ignore-scripts`)
+- **LSP** for indexing: [sysml-v2-lsp](https://www.npmjs.com/package/sysml-v2-lsp), installed in **`lsp/`** (see below)
+
+## Install
+
+```bash
+npm install
+npm run build
+npm run setup-lsp
+```
+
+- **setup-lsp** installs the SysML LSP in **`lsp/`** so the indexer can use it. No need to set `SYSMLLSP_SERVER_PATH` when using this default. See [docs/INSTALL.md](docs/INSTALL.md) and [docs/PLAN_INDEPENDENT_LSP.md](docs/PLAN_INDEPENDENT_LSP.md).
+
+## Usage
+
+### CLI
+
+| Command | Description |
+|--------|-------------|
+| `npx sysmledgraph analyze <path>` | Index path(s); discover `.sysml`, build graph (uses LSP in `lsp/` by default) |
+| `npx sysmledgraph list` | List indexed root paths |
+| `npx sysmledgraph clean [path]` | Remove index for path or all |
+
+**Scripts (from repo root):**
+
+- `npm run index-and-map [path]` — Index path (default `test/fixtures/sysml`), then write **graph-map.md**
+- `npm run generate-map [out.md]` — Generate map from existing DB
+- `npm run setup-lsp` — Install LSP in `lsp/` (Option C, see plan)
+
+### MCP (Cursor)
+
+This repo runs as an **MCP server** so Cursor AI can query the graph (query, context, impact, generate_map, indexDbGraph, cypher, etc.). Add **sysmledgraph** to `.cursor/mcp.json`; see [docs/MCP_SERVER_FOR_CURSOR.md](docs/MCP_SERVER_FOR_CURSOR.md).
+
+**Storage:** Default `~/.sysmledgraph`. Override with `SYSMEDGRAPH_STORAGE_ROOT`. Only one process should open the same DB at a time (see [docs/MCP_INTERACTION_GUIDE.md](docs/MCP_INTERACTION_GUIDE.md) §8).
+
+## Docs
+
+| Doc | Content |
+|-----|--------|
+| [docs/INSTALL.md](docs/INSTALL.md) | Install steps, LSP, Kuzu |
+| [docs/MCP_SERVER_FOR_CURSOR.md](docs/MCP_SERVER_FOR_CURSOR.md) | Enable sysmledgraph MCP in Cursor, tools, checklist |
+| [docs/MCP_INTERACTION_GUIDE.md](docs/MCP_INTERACTION_GUIDE.md) | LSP vs MCP, indexing, troubleshooting |
+| [docs/PLAN_INDEPENDENT_LSP.md](docs/PLAN_INDEPENDENT_LSP.md) | Why LSP is in `lsp/` only for sysmledgraph |
+| [lsp/README.md](lsp/README.md) | LSP folder setup and cwd |
+
+## Publishing (npm)
+
+You can publish this package to npm so others can install it with `npm install sysmledgraph` or `npx sysmledgraph analyze <path>`.
+
+1. **Name:** The package name is **`sysmledgraph`**. If it is already taken, use a scoped name (e.g. `@yourusername/sysmledgraph`) and set it in `package.json` `"name"`.
+2. **Build:** `prepublishOnly` runs `npm run build` before packing, so **dist/** is included in the tarball.
+3. **Included files:** Only **dist**, **scripts**, **lsp**, **README.md**, and **docs** are published (see `package.json` `"files"`). Users run **`npm run setup-lsp`** after install to install the LSP in **lsp/**.
+4. **Publish:** From a clean build, run:
+   ```bash
+   npm login
+   npm publish
+   ```
+   For a scoped package (e.g. `@user/sysmledgraph`), use `npm publish --access public` the first time.
+
+After publish, users can install with `npm install sysmledgraph`, then run **`npm run setup-lsp`** from the installed package directory (e.g. `cd node_modules/sysmledgraph && npm run setup-lsp`) so the LSP is available. When using **npx sysmledgraph** from another project, the default LSP path is resolved from the **current working directory** (that project’s `lsp/` or `node_modules/sysml-v2-lsp`). So either run setup-lsp inside the sysmledgraph package and set **SYSMLLSP_SERVER_PATH** to that `lsp/node_modules/.../server.js`, or install **sysml-v2-lsp** in the consumer project so the fallback finds it.
+
+## License
+
+MIT

package/dist/bin/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * CLI entrypoint: analyze, list, clean.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/bin/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../bin/cli.ts"],"names":[],"mappings":";AACA;;GAEG"}

package/dist/bin/cli.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+/**
+ * CLI entrypoint: analyze, list, clean.
+ */
+import { program } from 'commander';
+import { configureStorageRoot, cmdAnalyze, cmdList, cmdClean, } from '../src/cli/commands.js';
+program
+    .name('sysmledgraph')
+    .description('Path-only SysML indexer: knowledge graph, MCP server, CLI')
+    .option('--storage <path>', 'Storage root (default: ~/.sysmledgraph)', process.env.SYSMEDGRAPH_STORAGE_ROOT);
+program
+    .command('analyze <paths...>', { isDefault: true })
+    .description('Index path(s): discover .sysml, build graph')
+    .action(async (paths) => {
+    const opts = program.opts();
+    configureStorageRoot(opts.storage);
+    if (paths.length > 0) {
+        process.stderr.write(`Indexing ${paths.length} path(s)...\n`);
+    }
+    const result = await cmdAnalyze(paths);
+    if (!result.ok) {
+        process.stderr.write((result.error ?? 'Unknown error') + '\n');
+        if (result.filesProcessed !== undefined && result.filesProcessed > 0) {
+            process.stderr.write(`(Indexed ${result.filesProcessed} file(s) before error.)\n`);
+        }
+        process.exit(1);
+    }
+    const n = result.filesProcessed ?? 0;
+    process.stderr.write(`Indexed ${n} file(s).\n`);
+    process.exit(0);
+});
+program
+    .command('list')
+    .description('List indexed path(s)')
+    .action(async () => {
+    configureStorageRoot(program.opts().storage);
+    const result = await cmdList();
+    if (!result.ok) {
+        process.stderr.write((result.error ?? 'Unknown error') + '\n');
+        process.exit(1);
+    }
+    for (const p of result.paths) {
+        console.log(p);
+    }
+});
+program
+    .command('clean [path]')
+    .description('Remove index for path or all')
+    .action(async (path) => {
+    configureStorageRoot(program.opts().storage);
+    const result = await cmdClean(path);
+    if (!result.ok) {
+        process.stderr.write((result.error ?? 'Unknown error') + '\n');
+        process.exit(1);
+    }
+});
+program.parseAsync().catch((err) => {
+    process.stderr.write(String(err) + '\n');
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../mcp/index.ts"],"names":[],"mappings":""}

package/dist/mcp/index.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * MCP server entrypoint (stdio). Used by Cursor and other MCP clients.
+ * Run: npx sysmledgraph-mcp or node dist/mcp/index.js
+ */
+import { runStdio } from '../src/mcp/server.js';
+runStdio();
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../mcp/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,QAAQ,EAAE,CAAC"}

package/dist/src/cli/commands.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CLI commands: analyze (index), list, clean. Phase 4 step 15.
+ * R8: on failure exit non-zero and write to stderr.
+ * When SYSMLEDGRAPH_USE_WORKER=1, all graph ops go through the worker; worker is closed after each command.
+ */
+export declare function configureStorageRoot(root: string | undefined): void;
+export declare function cmdAnalyze(paths: string[]): Promise<{
+    ok: boolean;
+    filesProcessed?: number;
+    error?: string;
+}>;
+export declare function cmdList(): Promise<{
+    ok: boolean;
+    paths: string[];
+    error?: string;
+}>;
+export declare function cmdClean(path: string | undefined): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export declare function getStorageRootPath(): string;
+//# sourceMappingURL=commands.d.ts.map

package/dist/src/cli/commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/cli/commands.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAEnE;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA2BnH;AAED,wBAAsB,OAAO,IAAI,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAezF;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAYjG;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/src/cli/commands.js

@@ -0,0 +1,87 @@
+/**
+ * CLI commands: analyze (index), list, clean. Phase 4 step 15.
+ * R8: on failure exit non-zero and write to stderr.
+ * When SYSMLEDGRAPH_USE_WORKER=1, all graph ops go through the worker; worker is closed after each command.
+ */
+import { resolve } from 'path';
+import { setStorageRoot, getStorageRoot, getDbPathForIndexedPath } from '../storage/location.js';
+import { listIndexedPaths } from '../storage/list.js';
+import { cleanIndex } from '../storage/clean.js';
+import { addToRegistry } from '../storage/registry.js';
+import { openGraphStore } from '../graph/graph-store.js';
+import { runIndexer } from '../indexer/indexer.js';
+import { useWorker, index, listIndexed, clean, closeWorker } from '../worker/gateway.js';
+export function configureStorageRoot(root) {
+    if (root)
+        setStorageRoot(root);
+}
+export async function cmdAnalyze(paths) {
+    if (paths.length === 0) {
+        return { ok: false, error: 'At least one path required' };
+    }
+    const resolved = paths.map((raw) => resolve(raw));
+    if (useWorker()) {
+        try {
+            return await index({ paths: resolved });
+        }
+        finally {
+            closeWorker();
+        }
+    }
+    const dbPath = getDbPathForIndexedPath(resolved[0]);
+    const store = await openGraphStore(dbPath);
+    try {
+        let totalProcessed = 0;
+        for (const p of resolved) {
+            if (store.deleteNodesForRoot)
+                await store.deleteNodesForRoot(p);
+            const result = await runIndexer(store, { roots: [p] });
+            if (!result.ok)
+                return { ok: false, filesProcessed: totalProcessed, error: result.error };
+            totalProcessed += result.filesProcessed;
+            await addToRegistry(p, new Date().toISOString());
+        }
+        return { ok: true, filesProcessed: totalProcessed };
+    }
+    finally {
+        if (store.close)
+            await store.close();
+    }
+}
+export async function cmdList() {
+    if (useWorker()) {
+        try {
+            const r = await listIndexed();
+            return r.ok ? { ok: true, paths: r.paths ?? [] } : { ok: false, paths: [], error: r.error };
+        }
+        finally {
+            closeWorker();
+        }
+    }
+    try {
+        const paths = await listIndexedPaths();
+        return { ok: true, paths };
+    }
+    catch (err) {
+        return { ok: false, paths: [], error: err instanceof Error ? err.message : String(err) };
+    }
+}
+export async function cmdClean(path) {
+    if (useWorker()) {
+        try {
+            const result = await clean({ path });
+            return result.ok ? { ok: true } : { ok: false, error: result.error };
+        }
+        finally {
+            closeWorker();
+        }
+    }
+    const result = await cleanIndex(path);
+    if (!result.ok)
+        return { ok: false, error: result.error };
+    return { ok: true };
+}
+export function getStorageRootPath() {
+    return getStorageRoot();
+}
+//# sourceMappingURL=commands.js.map

package/dist/src/cli/commands.js.map

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

package/dist/src/discovery/find-sysml.d.ts

@@ -0,0 +1,16 @@
+/**
+ * File discovery: find all .sysml (and optionally .kerml) under path(s).
+ * Phase 1 step 4. Uses fast-glob.
+ */
+export interface FindSysmlOptions {
+    /** Include .kerml files. Default true. */
+    includeKerml?: boolean;
+    /** Root path(s) to search. */
+    roots: string[];
+}
+/**
+ * Find all .sysml files under the given roots (and optionally .kerml).
+ * Returns absolute paths, deduplicated.
+ */
+export declare function findSysmlFiles(options: FindSysmlOptions): Promise<string[]>;
+//# sourceMappingURL=find-sysml.d.ts.map

package/dist/src/discovery/find-sysml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-sysml.d.ts","sourceRoot":"","sources":["../../../src/discovery/find-sysml.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,gBAAgB;IAC/B,0CAA0C;IAC1C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8BAA8B;IAC9B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBjF"}

package/dist/src/discovery/find-sysml.js

@@ -0,0 +1,30 @@
+/**
+ * File discovery: find all .sysml (and optionally .kerml) under path(s).
+ * Phase 1 step 4. Uses fast-glob.
+ */
+import fg from 'fast-glob';
+const SYSML_GLOB = '**/*.sysml';
+const KERML_GLOB = '**/*.kerml';
+/**
+ * Find all .sysml files under the given roots (and optionally .kerml).
+ * Returns absolute paths, deduplicated.
+ */
+export async function findSysmlFiles(options) {
+    const { roots, includeKerml = true } = options;
+    const patterns = includeKerml ? [SYSML_GLOB, KERML_GLOB] : [SYSML_GLOB];
+    const seen = new Set();
+    for (const root of roots) {
+        for (const pattern of patterns) {
+            const files = await fg(pattern, {
+                cwd: root,
+                absolute: true,
+                onlyFiles: true,
+            });
+            for (const f of files) {
+                seen.add(f);
+            }
+        }
+    }
+    return [...seen].sort();
+}
+//# sourceMappingURL=find-sysml.js.map

package/dist/src/discovery/find-sysml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-sysml.js","sourceRoot":"","sources":["../../../src/discovery/find-sysml.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,WAAW,CAAC;AAG3B,MAAM,UAAU,GAAG,YAAY,CAAC;AAChC,MAAM,UAAU,GAAG,YAAY,CAAC;AAShC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAyB;IAC5D,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IAC/C,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,EAAE;gBAC9B,GAAG,EAAE,IAAI;gBACT,QAAQ,EAAE,IAAI;gBACd,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YACH,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/dist/src/discovery/load-order.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Load order: when config.yaml exists at path, use model_files; else deterministic (e.g. breadth-first by path).
+ * Phase 1 step 4, R7.
+ */
+/**
+ * Resolve ordered file list for a root path.
+ * If config.yaml exists, use model_files (paths relative to model_dir or root).
+ * Otherwise return files in deterministic order (sorted by path).
+ */
+export declare function applyLoadOrder(rootPath: string, files: string[]): Promise<string[]>;
+//# sourceMappingURL=load-order.d.ts.map

package/dist/src/discovery/load-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-order.d.ts","sourceRoot":"","sources":["../../../src/discovery/load-order.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA0CH;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,MAAM,EAAE,CAAC,CA0CnB"}

package/dist/src/discovery/load-order.js

@@ -0,0 +1,85 @@
+/**
+ * Load order: when config.yaml exists at path, use model_files; else deterministic (e.g. breadth-first by path).
+ * Phase 1 step 4, R7.
+ */
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+const CONFIG_FILENAME = 'config.yaml';
+/** Simple YAML parse for model_dir and model_files only (avoid heavy dependency). */
+function parseConfigYaml(raw) {
+    const out = {};
+    const lines = raw.split(/\r?\n/);
+    let inModelFiles = false;
+    const modelFiles = [];
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed.startsWith('model_dir:')) {
+            out.model_dir = trimmed.slice('model_dir:'.length).trim();
+            inModelFiles = false;
+            continue;
+        }
+        if (trimmed.startsWith('model_files:')) {
+            inModelFiles = true;
+            continue;
+        }
+        if (inModelFiles && trimmed.startsWith('-')) {
+            const value = trimmed.slice(1).trim();
+            if (value)
+                modelFiles.push(value);
+            continue;
+        }
+        if (trimmed && !trimmed.startsWith('#')) {
+            inModelFiles = false;
+        }
+    }
+    if (modelFiles.length > 0) {
+        out.model_files = modelFiles;
+    }
+    return out;
+}
+/**
+ * Resolve ordered file list for a root path.
+ * If config.yaml exists, use model_files (paths relative to model_dir or root).
+ * Otherwise return files in deterministic order (sorted by path).
+ */
+export async function applyLoadOrder(rootPath, files) {
+    const configPath = join(rootPath, CONFIG_FILENAME);
+    let raw;
+    try {
+        raw = await readFile(configPath, 'utf-8');
+    }
+    catch {
+        return [...files].sort();
+    }
+    const config = parseConfigYaml(raw);
+    if (!config.model_files || config.model_files.length === 0) {
+        return [...files].sort();
+    }
+    const modelDir = config.model_dir ? join(rootPath, config.model_dir) : rootPath;
+    const ordered = [];
+    const fileSet = new Set(files.map((f) => f.replace(/\\/g, '/')));
+    const byBasename = new Map();
+    for (const f of files) {
+        const base = f.split(/[/\\]/).pop() ?? f;
+        byBasename.set(base, f);
+    }
+    for (const rel of config.model_files) {
+        const resolved = join(modelDir, rel).replace(/\\/g, '/');
+        if (fileSet.has(resolved)) {
+            ordered.push(resolved);
+            continue;
+        }
+        const base = rel.split(/[/\\]/).pop();
+        if (base && byBasename.has(base)) {
+            ordered.push(byBasename.get(base));
+        }
+    }
+    // Append any files not in model_files (e.g. extra .sysml in subdirs)
+    for (const f of files) {
+        if (!ordered.includes(f)) {
+            ordered.push(f);
+        }
+    }
+    return ordered;
+}
+//# sourceMappingURL=load-order.js.map

package/dist/src/discovery/load-order.js.map

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

package/dist/src/graph/connection.d.ts

@@ -0,0 +1,6 @@
+/**
+ * getConnection() for Cypher. Phase 2.
+ */
+import type { GraphStore } from './graph-store.js';
+export declare function getConnection(store: GraphStore): unknown;
+//# sourceMappingURL=connection.d.ts.map

package/dist/src/graph/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/graph/connection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAExD"}

package/dist/src/graph/connection.js

@@ -0,0 +1,7 @@
+/**
+ * getConnection() for Cypher. Phase 2.
+ */
+export function getConnection(store) {
+    return store.getConnection();
+}
+//# sourceMappingURL=connection.js.map

package/dist/src/graph/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../../src/graph/connection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,aAAa,CAAC,KAAiB;IAC7C,OAAO,KAAK,CAAC,aAAa,EAAE,CAAC;AAC/B,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * GraphStore: open/create Kuzu DB, addDocument, addSymbol, addEdge, getConnection.
+ * Phase 2 step 7.
+ * Connection cache: one store per dbPath per process to avoid Kuzu "Could not set lock on file".
+ */
+import * as kuzu from 'kuzu';
+import type { NodeLabel, SymbolProps } from '../types.js';
+export interface GraphStore {
+    addDocument(path: string, indexedAt?: string): Promise<void>;
+    addSymbol(label: NodeLabel, props: SymbolProps): Promise<void>;
+    addEdge(fromId: string, toId: string, type: string): Promise<void>;
+    getConnection(): kuzu.Connection;
+    /** Delete all nodes whose path equals rootPath or starts with rootPath + sep (for merged graph clean/re-index). */
+    deleteNodesForRoot?(rootPath: string): Promise<void>;
+    /** Close the connection and database so the DB file can be reopened or deleted. Call before invalidate. */
+    close?(): Promise<void>;
+}
+/**
+ * Create or open a GraphStore at the given DB path. Initializes schema if new.
+ */
+export declare function openGraphStore(dbPath: string): Promise<GraphStore>;
+/**
+ * Return cached GraphStore for dbPath or open once and cache it.
+ * Use this in MCP tools so repeated/concurrent requests share one connection per DB (avoids Kuzu lock errors).
+ */
+export declare function getCachedOrOpenGraphStore(dbPath: string): Promise<GraphStore>;
+/**
+ * Remove cached store for dbPath. Next getCachedOrOpenGraphStore(dbPath) will open a new connection.
+ * Call before re-index or clean so the next access sees the new or removed DB.
+ */
+export declare function invalidateGraphStoreCache(dbPath: string): void;
+/**
+ * Close the cached store for dbPath and remove it from the cache. Use before clean or when the DB file will be deleted/reopened.
+ * Avoids "Could not set lock on file" when the same process reopens or deletes the DB.
+ */
+export declare function closeGraphStoreCache(dbPath: string): Promise<void>;
+//# sourceMappingURL=graph-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graph-store.d.ts","sourceRoot":"","sources":["../../../src/graph/graph-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAS1D,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7D,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,aAAa,IAAI,IAAI,CAAC,UAAU,CAAC;IACjC,mHAAmH;IACnH,kBAAkB,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD,2GAA2G;IAC3G,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAuExE;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAMnF;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAE9D;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxE"}

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

@@ -0,0 +1,108 @@
+/**
+ * GraphStore: open/create Kuzu DB, addDocument, addSymbol, addEdge, getConnection.
+ * Phase 2 step 7.
+ * Connection cache: one store per dbPath per process to avoid Kuzu "Could not set lock on file".
+ */
+import * as kuzu from 'kuzu';
+import { mkdir } from 'fs/promises';
+import { dirname } from 'path';
+import { getSchemaDdl, NODE_TABLE } from './schema.js';
+const storeCache = new Map();
+function escapeCypherString(s) {
+    return s.replace(/\\/g, '\\\\').replace(/'/g, "\\'");
+}
+/**
+ * Create or open a GraphStore at the given DB path. Initializes schema if new.
+ */
+export async function openGraphStore(dbPath) {
+    await mkdir(dirname(dbPath), { recursive: true });
+    const db = new kuzu.Database(dbPath);
+    const conn = new kuzu.Connection(db);
+    for (const ddl of getSchemaDdl()) {
+        try {
+            await conn.query(ddl);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            if (!msg.includes('already exists'))
+                throw e;
+        }
+    }
+    async function addDocument(path, _indexedAt) {
+        const pathEsc = escapeCypherString(path);
+        const label = 'Document';
+        await conn.query(`MERGE (n:${NODE_TABLE} {id: '${pathEsc}'}) ON CREATE SET n.name = '${pathEsc}', n.path = '${pathEsc}', n.label = '${label}' ON MATCH SET n.name = '${pathEsc}', n.path = '${pathEsc}', n.label = '${label}'`);
+    }
+    async function addSymbol(label, props) {
+        const id = props.qualifiedName ?? `${props.path}:${props.name}`;
+        const nameEsc = escapeCypherString(props.name);
+        const pathEsc = escapeCypherString(props.path);
+        const idEsc = escapeCypherString(id);
+        const labelEsc = escapeCypherString(label);
+        await conn.query(`MERGE (n:${NODE_TABLE} {id: '${idEsc}'}) ON CREATE SET n.name = '${nameEsc}', n.path = '${pathEsc}', n.label = '${labelEsc}' ON MATCH SET n.name = '${nameEsc}', n.path = '${pathEsc}', n.label = '${labelEsc}'`);
+    }
+    async function addEdge(fromId, toId, type) {
+        const fromEsc = escapeCypherString(fromId);
+        const toEsc = escapeCypherString(toId);
+        await conn.query(`MATCH (a:${NODE_TABLE} {id: '${fromEsc}'}), (b:${NODE_TABLE} {id: '${toEsc}'}) MERGE (a)-[:${type}]->(b)`);
+    }
+    /** Delete nodes for one indexed root (path = root or path under root). Used for clean and re-index with merged graph. */
+    async function deleteNodesForRoot(rootPath) {
+        const rootEsc = escapeCypherString(rootPath);
+        const rootPrefixEscFwd = escapeCypherString(rootPath.replace(/\\/g, '/') + '/');
+        const rootPrefixEscBk = escapeCypherString(rootPath + (rootPath.endsWith('\\') ? '' : '\\'));
+        try {
+            await conn.query(`MATCH (n:${NODE_TABLE}) WHERE n.path = '${rootEsc}' OR starts_with(n.path, '${rootPrefixEscFwd}') OR starts_with(n.path, '${rootPrefixEscBk}') DETACH DELETE n`);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            if (msg.includes('starts_with') || msg.includes('DETACH')) {
+                await conn.query(`MATCH (n:${NODE_TABLE}) WHERE n.path = '${rootEsc}' DETACH DELETE n`);
+            }
+            else
+                throw e;
+        }
+    }
+    async function close() {
+        await conn.close();
+        await db.close();
+    }
+    return {
+        addDocument,
+        addSymbol,
+        addEdge,
+        getConnection: () => conn,
+        deleteNodesForRoot,
+        close,
+    };
+}
+/**
+ * Return cached GraphStore for dbPath or open once and cache it.
+ * Use this in MCP tools so repeated/concurrent requests share one connection per DB (avoids Kuzu lock errors).
+ */
+export async function getCachedOrOpenGraphStore(dbPath) {
+    const cached = storeCache.get(dbPath);
+    if (cached)
+        return cached;
+    const store = await openGraphStore(dbPath);
+    storeCache.set(dbPath, store);
+    return store;
+}
+/**
+ * Remove cached store for dbPath. Next getCachedOrOpenGraphStore(dbPath) will open a new connection.
+ * Call before re-index or clean so the next access sees the new or removed DB.
+ */
+export function invalidateGraphStoreCache(dbPath) {
+    storeCache.delete(dbPath);
+}
+/**
+ * Close the cached store for dbPath and remove it from the cache. Use before clean or when the DB file will be deleted/reopened.
+ * Avoids "Could not set lock on file" when the same process reopens or deletes the DB.
+ */
+export async function closeGraphStoreCache(dbPath) {
+    const store = storeCache.get(dbPath);
+    if (store?.close)
+        await store.close();
+    storeCache.delete(dbPath);
+}
+//# sourceMappingURL=graph-store.js.map

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

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