sdl-mcp 0.6.0

package/dist/util/asyncFs.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Async file system operations with concurrency control.
+ *
+ * Wraps Node.js fs operations with async/await and applies
+ * concurrency limits to prevent resource exhaustion.
+ */
+import { ConcurrencyLimiter } from "./concurrency.js";
+/**
+ * Configuration for async file operations.
+ */
+export interface AsyncFsConfig {
+    /**
+     * Maximum concurrent file read operations.
+     */
+    maxConcurrentReads?: number;
+    /**
+     * Maximum concurrent file stat operations.
+     */
+    maxConcurrentStats?: number;
+    /**
+     * Concurrency limiter instance (optional, overrides maxConcurrent settings).
+     */
+    limiter?: ConcurrencyLimiter;
+}
+declare class AsyncFsOperations {
+    private readLimiter;
+    private statLimiter;
+    constructor(config?: AsyncFsConfig);
+    /**
+     * Reads a file's content asynchronously with concurrency control.
+     *
+     * @param filePath - Path to the file to read
+     * @param encoding - File encoding (default: "utf-8")
+     * @returns Promise that resolves with file content
+     */
+    readFile(filePath: string, encoding?: BufferEncoding): Promise<string>;
+    /**
+     * Gets file statistics asynchronously with concurrency control.
+     *
+     * @param filePath - Path to the file
+     * @returns Promise that resolves with file stats
+     */
+    stat(filePath: string): Promise<import("fs").Stats>;
+    /**
+     * Checks if a file exists asynchronously.
+     *
+     * @param filePath - Path to check
+     * @returns Promise that resolves with true if file exists
+     */
+    exists(filePath: string): Promise<boolean>;
+    /**
+     * Checks if a file is readable asynchronously.
+     *
+     * @param filePath - Path to check
+     * @returns Promise that resolves with true if file is readable
+     */
+    isReadable(filePath: string): Promise<boolean>;
+    /**
+     * Gets file size asynchronously with caching hint.
+     *
+     * @param filePath - Path to the file
+     * @returns Promise that resolves with file size in bytes
+     */
+    getFileSize(filePath: string): Promise<number>;
+    /**
+     * Gets file modification time asynchronously.
+     *
+     * @param filePath - Path to the file
+     * @returns Promise that resolves with modification timestamp
+     */
+    getMtime(filePath: string): Promise<Date>;
+}
+/**
+ * Creates a new async file system operations instance with optional config.
+ *
+ * @param config - Optional configuration
+ * @returns New AsyncFsOperations instance
+ */
+export declare function createAsyncFsOperations(config?: AsyncFsConfig): AsyncFsOperations;
+/**
+ * Convenience function to read a file with concurrency control.
+ *
+ * @param filePath - Path to the file
+ * @param encoding - File encoding
+ * @returns Promise that resolves with file content
+ */
+export declare function readFileAsync(filePath: string, encoding?: BufferEncoding): Promise<string>;
+/**
+ * Convenience function to get file stats with concurrency control.
+ *
+ * @param filePath - Path to the file
+ * @returns Promise that resolves with file stats
+ */
+export declare function statAsync(filePath: string): Promise<import("fs").Stats>;
+/**
+ * Convenience function to check if file exists asynchronously.
+ *
+ * @param filePath - Path to check
+ * @returns Promise that resolves with true if file exists
+ */
+export declare function existsAsync(filePath: string): Promise<boolean>;
+export {};
+//# sourceMappingURL=asyncFs.d.ts.map

package/dist/util/asyncFs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asyncFs.d.ts","sourceRoot":"","sources":["../../src/util/asyncFs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED,cAAM,iBAAiB;IACrB,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,WAAW,CAAqB;gBAE5B,MAAM,GAAE,aAAkB;IAoBtC;;;;;;OAMG;IACG,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,GAAE,cAAwB,GACjC,OAAO,CAAC,MAAM,CAAC;IAIlB;;;;;OAKG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,KAAK,CAAC;IAIzD;;;;;OAKG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAShD;;;;;OAKG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASpD;;;;;OAKG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKpD;;;;;OAKG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAIhD;AAID;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,CAAC,EAAE,aAAa,GACrB,iBAAiB,CAEnB;AAED;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,cAAc,GACxB,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;;;;GAKG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,IAAI,EAAE,KAAK,CAAC,CAE7E;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpE"}

package/dist/util/asyncFs.js

@@ -0,0 +1,133 @@
+/**
+ * Async file system operations with concurrency control.
+ *
+ * Wraps Node.js fs operations with async/await and applies
+ * concurrency limits to prevent resource exhaustion.
+ */
+import { readFile, stat, access, constants } from "fs/promises";
+import { ConcurrencyLimiter } from "./concurrency.js";
+class AsyncFsOperations {
+    readLimiter;
+    statLimiter;
+    constructor(config = {}) {
+        const { maxConcurrentReads = 10, maxConcurrentStats = 10, limiter, } = config;
+        this.readLimiter =
+            limiter ??
+                new ConcurrencyLimiter({
+                    maxConcurrency: maxConcurrentReads,
+                });
+        this.statLimiter =
+            limiter ??
+                new ConcurrencyLimiter({
+                    maxConcurrency: maxConcurrentStats,
+                });
+    }
+    /**
+     * Reads a file's content asynchronously with concurrency control.
+     *
+     * @param filePath - Path to the file to read
+     * @param encoding - File encoding (default: "utf-8")
+     * @returns Promise that resolves with file content
+     */
+    async readFile(filePath, encoding = "utf-8") {
+        return this.readLimiter.run(() => readFile(filePath, encoding));
+    }
+    /**
+     * Gets file statistics asynchronously with concurrency control.
+     *
+     * @param filePath - Path to the file
+     * @returns Promise that resolves with file stats
+     */
+    async stat(filePath) {
+        return this.statLimiter.run(() => stat(filePath));
+    }
+    /**
+     * Checks if a file exists asynchronously.
+     *
+     * @param filePath - Path to check
+     * @returns Promise that resolves with true if file exists
+     */
+    async exists(filePath) {
+        try {
+            await access(filePath, constants.F_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Checks if a file is readable asynchronously.
+     *
+     * @param filePath - Path to check
+     * @returns Promise that resolves with true if file is readable
+     */
+    async isReadable(filePath) {
+        try {
+            await access(filePath, constants.R_OK);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Gets file size asynchronously with caching hint.
+     *
+     * @param filePath - Path to the file
+     * @returns Promise that resolves with file size in bytes
+     */
+    async getFileSize(filePath) {
+        const stats = await this.stat(filePath);
+        return stats.size;
+    }
+    /**
+     * Gets file modification time asynchronously.
+     *
+     * @param filePath - Path to the file
+     * @returns Promise that resolves with modification timestamp
+     */
+    async getMtime(filePath) {
+        const stats = await this.stat(filePath);
+        return stats.mtime;
+    }
+}
+const defaultInstance = new AsyncFsOperations();
+/**
+ * Creates a new async file system operations instance with optional config.
+ *
+ * @param config - Optional configuration
+ * @returns New AsyncFsOperations instance
+ */
+export function createAsyncFsOperations(config) {
+    return new AsyncFsOperations(config);
+}
+/**
+ * Convenience function to read a file with concurrency control.
+ *
+ * @param filePath - Path to the file
+ * @param encoding - File encoding
+ * @returns Promise that resolves with file content
+ */
+export async function readFileAsync(filePath, encoding) {
+    return defaultInstance.readFile(filePath, encoding);
+}
+/**
+ * Convenience function to get file stats with concurrency control.
+ *
+ * @param filePath - Path to the file
+ * @returns Promise that resolves with file stats
+ */
+export async function statAsync(filePath) {
+    return defaultInstance.stat(filePath);
+}
+/**
+ * Convenience function to check if file exists asynchronously.
+ *
+ * @param filePath - Path to check
+ * @returns Promise that resolves with true if file exists
+ */
+export async function existsAsync(filePath) {
+    return defaultInstance.exists(filePath);
+}
+//# sourceMappingURL=asyncFs.js.map

package/dist/util/asyncFs.js.map

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

package/dist/util/concurrency.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Concurrency limiter utility for controlling parallel operations.
+ *
+ * Provides a simple semaphore-based mechanism to limit the number of
+ * concurrent operations, preventing resource exhaustion and improving
+ * performance under load.
+ *
+ * @example
+ * ```typescript
+ * const limiter = new ConcurrencyLimiter(4); // Limit to 4 concurrent operations
+ * await limiter.run(() => readFileAsync(path));
+ * ```
+ */
+export interface ConcurrencyLimiterOptions {
+    /**
+     * Maximum number of concurrent operations allowed.
+     */
+    maxConcurrency: number;
+    /**
+     * Optional timeout for queued operations in milliseconds.
+     * If not provided, operations wait indefinitely.
+     */
+    queueTimeoutMs?: number;
+}
+export declare class ConcurrencyLimiter {
+    private maxConcurrency;
+    private queueTimeoutMs;
+    private activeCount;
+    private queue;
+    constructor(options: ConcurrencyLimiterOptions);
+    /**
+     * Executes a task within the concurrency limit.
+     *
+     * @param task - Async function to execute
+     * @param timeoutMs - Optional timeout override for this specific task
+     * @returns Promise that resolves with the task's result
+     */
+    run<T>(task: () => Promise<T>, timeoutMs?: number): Promise<T>;
+    private executeTask;
+    private processQueue;
+    /**
+     * Gets current statistics about the limiter.
+     *
+     * @returns Object with active count and queue length
+     */
+    getStats(): {
+        active: number;
+        queued: number;
+    };
+    /**
+     * Clears all pending tasks from the queue.
+     *
+     * @param error - Optional error to reject all queued tasks with
+     */
+    clearQueue(error?: Error): void;
+    /**
+     * Waits for all active tasks to complete.
+     *
+     * @returns Promise that resolves when no tasks are active
+     */
+    drain(): Promise<void>;
+}
+/**
+ * Creates a limiter for file system operations.
+ *
+ * @param concurrency - Maximum concurrent file operations
+ * @returns Configured ConcurrencyLimiter
+ */
+export declare function createFileIOLimiter(concurrency: number): ConcurrencyLimiter;
+/**
+ * Creates a limiter for database operations.
+ *
+ * @param concurrency - Maximum concurrent database queries
+ * @returns Configured ConcurrencyLimiter
+ */
+export declare function createDbIOLimiter(concurrency: number): ConcurrencyLimiter;
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/util/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/util/concurrency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAIV;gBAES,OAAO,EAAE,yBAAyB;IAW9C;;;;;;OAMG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;YAoCtD,WAAW;IAyBzB,OAAO,CAAC,YAAY;IAWpB;;;;OAIG;IACH,QAAQ,IAAI;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAO9C;;;;OAIG;IACH,UAAU,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI;IAU/B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAK7B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAI3E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,kBAAkB,CAIzE"}

package/dist/util/concurrency.js

@@ -0,0 +1,146 @@
+/**
+ * Concurrency limiter utility for controlling parallel operations.
+ *
+ * Provides a simple semaphore-based mechanism to limit the number of
+ * concurrent operations, preventing resource exhaustion and improving
+ * performance under load.
+ *
+ * @example
+ * ```typescript
+ * const limiter = new ConcurrencyLimiter(4); // Limit to 4 concurrent operations
+ * await limiter.run(() => readFileAsync(path));
+ * ```
+ */
+export class ConcurrencyLimiter {
+    maxConcurrency;
+    queueTimeoutMs;
+    activeCount;
+    queue;
+    constructor(options) {
+        if (options.maxConcurrency < 1) {
+            throw new Error("maxConcurrency must be at least 1");
+        }
+        this.maxConcurrency = options.maxConcurrency;
+        this.queueTimeoutMs = options.queueTimeoutMs;
+        this.activeCount = 0;
+        this.queue = [];
+    }
+    /**
+     * Executes a task within the concurrency limit.
+     *
+     * @param task - Async function to execute
+     * @param timeoutMs - Optional timeout override for this specific task
+     * @returns Promise that resolves with the task's result
+     */
+    async run(task, timeoutMs) {
+        if (this.activeCount < this.maxConcurrency) {
+            return this.executeTask(task, timeoutMs);
+        }
+        return new Promise((resolve, reject) => {
+            const timeout = timeoutMs ?? this.queueTimeoutMs ?? undefined;
+            let timeoutHandle;
+            const item = {
+                resolve: resolve,
+                reject,
+                task: () => {
+                    if (timeoutHandle) {
+                        clearTimeout(timeoutHandle);
+                    }
+                    return task();
+                },
+            };
+            if (timeout) {
+                timeoutHandle = setTimeout(() => {
+                    const index = this.queue.indexOf(item);
+                    if (index !== -1) {
+                        this.queue.splice(index, 1);
+                    }
+                    reject(new Error(`ConcurrencyLimiter queue timeout after ${timeout}ms`));
+                }, timeout);
+            }
+            this.queue.push(item);
+        });
+    }
+    async executeTask(task, timeoutMs) {
+        this.activeCount++;
+        try {
+            if (timeoutMs) {
+                return await Promise.race([
+                    task(),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error(`Task timeout after ${timeoutMs}ms`)), timeoutMs)),
+                ]);
+            }
+            return await task();
+        }
+        finally {
+            this.activeCount--;
+            this.processQueue();
+        }
+    }
+    processQueue() {
+        while (this.queue.length > 0 && this.activeCount < this.maxConcurrency) {
+            const item = this.queue.shift();
+            if (item) {
+                this.executeTask(item.task)
+                    .then((result) => item.resolve(result))
+                    .catch((error) => item.reject(error));
+            }
+        }
+    }
+    /**
+     * Gets current statistics about the limiter.
+     *
+     * @returns Object with active count and queue length
+     */
+    getStats() {
+        return {
+            active: this.activeCount,
+            queued: this.queue.length,
+        };
+    }
+    /**
+     * Clears all pending tasks from the queue.
+     *
+     * @param error - Optional error to reject all queued tasks with
+     */
+    clearQueue(error) {
+        const errorToUse = error ?? new Error("ConcurrencyLimiter queue cleared");
+        for (const item of this.queue) {
+            item.reject(errorToUse);
+        }
+        this.queue.length = 0;
+    }
+    /**
+     * Waits for all active tasks to complete.
+     *
+     * @returns Promise that resolves when no tasks are active
+     */
+    async drain() {
+        while (this.activeCount > 0 || this.queue.length > 0) {
+            await new Promise((resolve) => setTimeout(resolve, 10));
+        }
+    }
+}
+/**
+ * Creates a limiter for file system operations.
+ *
+ * @param concurrency - Maximum concurrent file operations
+ * @returns Configured ConcurrencyLimiter
+ */
+export function createFileIOLimiter(concurrency) {
+    return new ConcurrencyLimiter({
+        maxConcurrency: concurrency,
+    });
+}
+/**
+ * Creates a limiter for database operations.
+ *
+ * @param concurrency - Maximum concurrent database queries
+ * @returns Configured ConcurrencyLimiter
+ */
+export function createDbIOLimiter(concurrency) {
+    return new ConcurrencyLimiter({
+        maxConcurrency: concurrency,
+    });
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/util/concurrency.js.map

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

package/dist/util/depLabels.d.ts

@@ -0,0 +1,3 @@
+export declare function isOpaqueSymbolIdRef(value: string): boolean;
+export declare function pickDepLabel(targetId: string, targetName?: string): string | undefined;
+//# sourceMappingURL=depLabels.d.ts.map

package/dist/util/depLabels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"depLabels.d.ts","sourceRoot":"","sources":["../../src/util/depLabels.ts"],"names":[],"mappings":"AAIA,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CActF"}

package/dist/util/depLabels.js

@@ -0,0 +1,19 @@
+import { DEP_LABEL_MAX_LENGTH } from "../config/constants.js";
+const OPAQUE_SYMBOL_ID_PATTERN = /^[a-f0-9]{64}$/i;
+export function isOpaqueSymbolIdRef(value) {
+    return OPAQUE_SYMBOL_ID_PATTERN.test(value);
+}
+export function pickDepLabel(targetId, targetName) {
+    if (targetName && targetName.length > 0) {
+        return targetName.length > DEP_LABEL_MAX_LENGTH
+            ? targetName.slice(0, DEP_LABEL_MAX_LENGTH)
+            : targetName;
+    }
+    if (isOpaqueSymbolIdRef(targetId)) {
+        return undefined;
+    }
+    return targetId.length > DEP_LABEL_MAX_LENGTH
+        ? targetId.slice(0, DEP_LABEL_MAX_LENGTH)
+        : targetId;
+}
+//# sourceMappingURL=depLabels.js.map

package/dist/util/depLabels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"depLabels.js","sourceRoot":"","sources":["../../src/util/depLabels.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,wBAAwB,GAAG,iBAAiB,CAAC;AAEnD,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,UAAmB;IAChE,IAAI,UAAU,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxC,OAAO,UAAU,CAAC,MAAM,GAAG,oBAAoB;YAC7C,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC;YAC3C,CAAC,CAAC,UAAU,CAAC;IACjB,CAAC;IAED,IAAI,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,GAAG,oBAAoB;QAC3C,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,oBAAoB,CAAC;QACzC,CAAC,CAAC,QAAQ,CAAC;AACf,CAAC"}

package/dist/util/findPackageRoot.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Find the nearest directory at/above startDir that contains package.json.
+ * This lets compiled code (dist/...) locate repo resources (config/, migrations/, etc.)
+ * without relying on fragile relative paths.
+ */
+export declare function findPackageRoot(startDir: string, maxDepth?: number): string;
+//# sourceMappingURL=findPackageRoot.d.ts.map

package/dist/util/findPackageRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findPackageRoot.d.ts","sourceRoot":"","sources":["../../src/util/findPackageRoot.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAW,GAAG,MAAM,CAW/E"}

package/dist/util/findPackageRoot.js

@@ -0,0 +1,21 @@
+import { existsSync } from "fs";
+import { dirname, resolve } from "path";
+/**
+ * Find the nearest directory at/above startDir that contains package.json.
+ * This lets compiled code (dist/...) locate repo resources (config/, migrations/, etc.)
+ * without relying on fragile relative paths.
+ */
+export function findPackageRoot(startDir, maxDepth = 10) {
+    let dir = resolve(startDir);
+    for (let i = 0; i < maxDepth; i++) {
+        if (existsSync(resolve(dir, "package.json"))) {
+            return dir;
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return resolve(startDir);
+}
+//# sourceMappingURL=findPackageRoot.js.map

package/dist/util/findPackageRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"findPackageRoot.js","sourceRoot":"","sources":["../../src/util/findPackageRoot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAExC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB,EAAE,WAAmB,EAAE;IACrE,IAAI,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YAC7C,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC"}

package/dist/util/hashing.d.ts

@@ -0,0 +1,9 @@
+import type { SymbolCard } from "../mcp/types.js";
+export type NormalizedValue = null | string | number | boolean | NormalizedValue[] | {
+    [key: string]: NormalizedValue;
+};
+export declare function hashContent(content: string): string;
+export declare function generateSymbolId(repoId: string, relPath: string, kind: string, name: string, astFingerprint: string): string;
+export declare function normalizeCard(card: SymbolCard): NormalizedValue;
+export declare function hashCard(card: SymbolCard): string;
+//# sourceMappingURL=hashing.d.ts.map

package/dist/util/hashing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashing.d.ts","sourceRoot":"","sources":["../../src/util/hashing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,MAAM,eAAe,GACvB,IAAI,GACJ,MAAM,GACN,MAAM,GACN,OAAO,GACP,eAAe,EAAE,GACjB;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,CAAA;CAAE,CAAC;AAEvC,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,MAAM,GACrB,MAAM,CAGR;AA4BD,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,eAAe,CAE/D;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAIjD"}

package/dist/util/hashing.js

@@ -0,0 +1,37 @@
+import * as crypto from "crypto";
+export function hashContent(content) {
+    return crypto.createHash("sha256").update(content).digest("hex");
+}
+export function generateSymbolId(repoId, relPath, kind, name, astFingerprint) {
+    const combined = `${repoId}:${relPath}:${kind}:${name}:${astFingerprint}`;
+    return crypto.createHash("sha256").update(combined).digest("hex");
+}
+function normalizeObject(obj) {
+    if (obj === null || obj === undefined) {
+        return null;
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(normalizeObject);
+    }
+    if (typeof obj === "object" && obj !== null) {
+        const normalized = {};
+        const sortedKeys = Object.keys(obj).sort();
+        for (const key of sortedKeys) {
+            const value = obj[key];
+            if (value !== undefined) {
+                normalized[key] = normalizeObject(value);
+            }
+        }
+        return normalized;
+    }
+    return obj;
+}
+export function normalizeCard(card) {
+    return normalizeObject(card);
+}
+export function hashCard(card) {
+    const normalized = normalizeCard(card);
+    const canonical = JSON.stringify(normalized);
+    return hashContent(canonical);
+}
+//# sourceMappingURL=hashing.js.map

package/dist/util/hashing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashing.js","sourceRoot":"","sources":["../../src/util/hashing.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAWjC,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,MAAc,EACd,OAAe,EACf,IAAY,EACZ,IAAY,EACZ,cAAsB;IAEtB,MAAM,QAAQ,GAAG,GAAG,MAAM,IAAI,OAAO,IAAI,IAAI,IAAI,IAAI,IAAI,cAAc,EAAE,CAAC;IAC1E,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAED,SAAS,eAAe,CAAC,GAAY;IACnC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAoC,EAAE,CAAC;QACvD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,GAA8B,CAAC,CAAC,IAAI,EAAE,CAAC;QAEtE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAI,GAA+B,CAAC,GAAG,CAAC,CAAC;YACpD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,UAAU,CAAC,GAAG,CAAC,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,OAAO,GAAsB,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAgB;IAC5C,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAgB;IACvC,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC7C,OAAO,WAAW,CAAC,SAAS,CAAC,CAAC;AAChC,CAAC"}

package/dist/util/logger.d.ts

@@ -0,0 +1,14 @@
+export type LogLevel = "debug" | "info" | "warn" | "error";
+declare class Logger {
+    private level;
+    constructor(level?: LogLevel);
+    private shouldLog;
+    setLevel(level: LogLevel): void;
+    debug(message: string, meta?: Record<string, unknown>): void;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, meta?: Record<string, unknown>): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/util/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAe3D,cAAM,MAAM;IACV,OAAO,CAAC,KAAK,CAAW;gBAEZ,KAAK,GAAE,QAAiB;IAIpC,OAAO,CAAC,SAAS;IAKjB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI/B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAO5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAO3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAO3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAM7D;AAED,eAAO,MAAM,MAAM,QAAe,CAAC"}