sdl-mcp 0.6.0

package/dist/util/logger.js

@@ -0,0 +1,51 @@
+// MCP servers must use stderr for ALL logging - stdout is reserved for JSON-RPC
+const writeToStderr = (msg) => {
+    process.stderr.write(msg + "\n");
+};
+function safeStringify(obj) {
+    try {
+        return JSON.stringify(obj);
+    }
+    catch (e) {
+        return "[circular or unstringifiable]";
+    }
+}
+class Logger {
+    level;
+    constructor(level = "info") {
+        this.level = level;
+    }
+    shouldLog(level) {
+        const levels = ["debug", "info", "warn", "error"];
+        return levels.indexOf(level) >= levels.indexOf(this.level);
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+    debug(message, meta) {
+        if (this.shouldLog("debug")) {
+            const metaStr = meta ? " " + safeStringify(meta) : "";
+            writeToStderr(`[DEBUG] ${message}${metaStr}`);
+        }
+    }
+    info(message, meta) {
+        if (this.shouldLog("info")) {
+            const metaStr = meta ? " " + safeStringify(meta) : "";
+            writeToStderr(`[INFO] ${message}${metaStr}`);
+        }
+    }
+    warn(message, meta) {
+        if (this.shouldLog("warn")) {
+            const metaStr = meta ? " " + safeStringify(meta) : "";
+            writeToStderr(`[WARN] ${message}${metaStr}`);
+        }
+    }
+    error(message, meta) {
+        if (this.shouldLog("error")) {
+            const metaStr = meta ? " " + safeStringify(meta) : "";
+            writeToStderr(`[ERROR] ${message}${metaStr}`);
+        }
+    }
+}
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map

package/dist/util/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/util/logger.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,MAAM,aAAa,GAAG,CAAC,GAAW,EAAQ,EAAE;IAC1C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF,SAAS,aAAa,CAAC,GAA4B;IACjD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,+BAA+B,CAAC;IACzC,CAAC;AACH,CAAC;AAED,MAAM,MAAM;IACF,KAAK,CAAW;IAExB,YAAY,QAAkB,MAAM;QAClC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAEO,SAAS,CAAC,KAAe;QAC/B,MAAM,MAAM,GAAe,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC9D,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7D,CAAC;IAED,QAAQ,CAAC,KAAe;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,aAAa,CAAC,WAAW,OAAO,GAAG,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,aAAa,CAAC,UAAU,OAAO,GAAG,OAAO,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,IAA8B;QAClD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,aAAa,CAAC,UAAU,OAAO,GAAG,OAAO,EAAE,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,IAA8B;QACnD,IAAI,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACtD,aAAa,CAAC,WAAW,OAAO,GAAG,OAAO,EAAE,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF;AAED,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC"}

package/dist/util/paths.d.ts

@@ -0,0 +1,6 @@
+export declare function normalizePath(p: string): string;
+export declare function getRelativePath(from: string, to: string): string;
+export declare function safeJoin(...parts: string[]): string;
+export declare function validatePathWithinRoot(root: string, target: string): string;
+export declare function getAbsolutePathFromRepoRoot(repoRoot: string, relPath: string): string;
+//# sourceMappingURL=paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/util/paths.ts"],"names":[],"mappings":"AAcA,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAY/C;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAgBhE;AAED,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAcnD;AAUD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CA4B3E;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,MAAM,CAOR"}

package/dist/util/paths.js

@@ -0,0 +1,79 @@
+import * as path from "path";
+function toForwardSlashes(p) {
+    return p.replace(/\\/g, "/");
+}
+function toBackSlashes(p) {
+    return p.replace(/\//g, "\\");
+}
+function isWindowsPathLike(p) {
+    return /^[A-Za-z]:[\\/]/.test(p) || p.startsWith("\\\\") || p.startsWith("//");
+}
+export function normalizePath(p) {
+    if (p === "") {
+        return path.posix.normalize(p);
+    }
+    const slashNormalized = toForwardSlashes(p);
+    if (isWindowsPathLike(slashNormalized)) {
+        const winNormalized = path.win32.normalize(toBackSlashes(slashNormalized));
+        return toForwardSlashes(winNormalized);
+    }
+    return path.posix.normalize(slashNormalized);
+}
+export function getRelativePath(from, to) {
+    const normalizedFrom = normalizePath(from);
+    const normalizedTo = normalizePath(to);
+    const useWindowsPaths = isWindowsPathLike(normalizedFrom) || isWindowsPathLike(normalizedTo);
+    if (useWindowsPaths) {
+        return normalizePath(path.win32.relative(toBackSlashes(normalizedFrom), toBackSlashes(normalizedTo)));
+    }
+    return normalizePath(path.posix.relative(normalizedFrom, normalizedTo));
+}
+export function safeJoin(...parts) {
+    if (parts.length === 0) {
+        return ".";
+    }
+    const normalizedParts = parts.map((part) => normalizePath(part));
+    if (isWindowsPathLike(normalizedParts[0])) {
+        const winResult = path.win32.join(...normalizedParts.map((part) => toBackSlashes(part)));
+        return normalizePath(winResult);
+    }
+    return normalizePath(path.posix.join(...normalizedParts));
+}
+function containsPathTraversal(p) {
+    const normalized = normalizePath(p);
+    if (normalized.startsWith(".."))
+        return true;
+    if (normalized.includes("/../"))
+        return true;
+    if (normalized.endsWith("/.."))
+        return true;
+    return false;
+}
+export function validatePathWithinRoot(root, target) {
+    const normalizedRootInput = normalizePath(root);
+    const normalizedTargetInput = normalizePath(target);
+    const useWindowsPaths = isWindowsPathLike(normalizedRootInput);
+    const absoluteRoot = useWindowsPaths
+        ? path.win32.resolve(toBackSlashes(normalizedRootInput))
+        : path.posix.resolve(normalizedRootInput);
+    const absoluteTarget = useWindowsPaths
+        ? path.win32.resolve(toBackSlashes(normalizedRootInput), toBackSlashes(normalizedTargetInput))
+        : path.posix.resolve(normalizedRootInput, normalizedTargetInput);
+    const normalizedRoot = normalizePath(absoluteRoot);
+    const normalizedTarget = normalizePath(absoluteTarget);
+    const rootPrefix = normalizedRoot.endsWith("/")
+        ? normalizedRoot
+        : `${normalizedRoot}/`;
+    if (normalizedTarget !== normalizedRoot && !normalizedTarget.startsWith(rootPrefix)) {
+        throw new Error(`Path traversal detected: ${target} escapes repository root`);
+    }
+    return absoluteTarget;
+}
+export function getAbsolutePathFromRepoRoot(repoRoot, relPath) {
+    if (containsPathTraversal(relPath)) {
+        throw new Error(`Path traversal sequence detected in: ${relPath}`);
+    }
+    const absolutePath = validatePathWithinRoot(repoRoot, relPath);
+    return normalizePath(absolutePath);
+}
+//# sourceMappingURL=paths.js.map

package/dist/util/paths.js.map

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

package/dist/util/time.d.ts

@@ -0,0 +1,4 @@
+export declare function getCurrentTimestamp(): string;
+export declare function formatDuration(milliseconds: number): string;
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=time.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/util/time.ts"],"names":[],"mappings":"AAAA,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAU3D;AAED,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/util/time.js

@@ -0,0 +1,20 @@
+export function getCurrentTimestamp() {
+    return new Date().toISOString();
+}
+export function formatDuration(milliseconds) {
+    const seconds = Math.floor(milliseconds / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0)
+        return `${days}d ${hours % 24}h`;
+    if (hours > 0)
+        return `${hours}h ${minutes % 60}m`;
+    if (minutes > 0)
+        return `${minutes}m ${seconds % 60}s`;
+    return `${seconds}s`;
+}
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=time.js.map

package/dist/util/time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time.js","sourceRoot":"","sources":["../../src/util/time.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,mBAAmB;IACjC,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,YAAoB;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAEpC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,GAAG,IAAI,KAAK,KAAK,GAAG,EAAE,GAAG,CAAC;IAC/C,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,GAAG,KAAK,KAAK,OAAO,GAAG,EAAE,GAAG,CAAC;IACnD,IAAI,OAAO,GAAG,CAAC;QAAE,OAAO,GAAG,OAAO,KAAK,OAAO,GAAG,EAAE,GAAG,CAAC;IACvD,OAAO,GAAG,OAAO,GAAG,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/util/tokenize.d.ts

@@ -0,0 +1,5 @@
+export declare function estimateTokens(text: string): number;
+export declare function calculateRemainingBudget(used: number, total: number): number;
+export declare function canFitTokens(tokens: number, budget: number): boolean;
+export declare function tokenize(text: string): string[];
+//# sourceMappingURL=tokenize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tokenize.d.ts","sourceRoot":"","sources":["../../src/util/tokenize.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWnD;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAO/C"}

package/dist/util/tokenize.js

@@ -0,0 +1,30 @@
+const PROSE_CHARS_PER_TOKEN = 3.5;
+const STRUCTURAL_TOKEN_CHARS = new Set(["{", "}", "[", "]", ":", ",", "\""]);
+export function estimateTokens(text) {
+    if (!text)
+        return 0;
+    let structuralChars = 0;
+    for (const char of text) {
+        if (STRUCTURAL_TOKEN_CHARS.has(char)) {
+            structuralChars++;
+        }
+    }
+    const proseChars = Math.max(0, text.length - structuralChars);
+    return Math.ceil(structuralChars + proseChars / PROSE_CHARS_PER_TOKEN);
+}
+export function calculateRemainingBudget(used, total) {
+    return Math.max(0, total - used);
+}
+export function canFitTokens(tokens, budget) {
+    return tokens <= budget;
+}
+export function tokenize(text) {
+    if (!text)
+        return [];
+    return text
+        .toLowerCase()
+        .replace(/[^\w\s.-]/g, ' ')
+        .split(/\s+/)
+        .filter(token => token.length > 0);
+}
+//# sourceMappingURL=tokenize.js.map

package/dist/util/tokenize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenize.js","sourceRoot":"","sources":["../../src/util/tokenize.ts"],"names":[],"mappings":"AAAA,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAClC,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC;AAE7E,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,eAAe,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC;IAC9D,OAAO,IAAI,CAAC,IAAI,CAAC,eAAe,GAAG,UAAU,GAAG,qBAAqB,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,KAAa;IAClE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,MAAc;IACzD,OAAO,MAAM,IAAI,MAAM,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,IAAI;SACR,WAAW,EAAE;SACb,OAAO,CAAC,YAAY,EAAE,GAAG,CAAC;SAC1B,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC"}

package/dist/util/truncation.d.ts

@@ -0,0 +1,38 @@
+import type { Range } from "../mcp/types.js";
+export interface TruncationMetadata {
+    truncated: boolean;
+    droppedCount: number;
+    howToResume: {
+        type: "cursor" | "token";
+        value: string | number;
+    } | null;
+}
+export interface TruncationOptions {
+    maxItems?: number;
+    maxTokens?: number;
+    maxLines?: number;
+    truncateAt?: "start" | "end";
+    preserveFirst?: number;
+    preserveLast?: number;
+}
+export interface TruncatedArray<T> extends TruncationMetadata {
+    items: T[];
+}
+export interface TruncatedText extends TruncationMetadata {
+    text: string;
+}
+export interface TruncatedResult<T> {
+    data: T;
+    truncation: TruncationMetadata;
+}
+export declare function applyCountTruncation<T>(items: T[], options: TruncationOptions): TruncatedArray<T>;
+export declare function applyTokenTruncation(text: string, options: TruncationOptions): TruncatedText;
+export declare function applyLineTruncation(text: string, options: TruncationOptions): TruncatedText;
+export declare function truncateText(text: string, options: TruncationOptions): TruncatedText;
+export declare function truncateArray<T>(items: T[], options: TruncationOptions): TruncatedArray<T>;
+export declare function truncateRange(range: Range, options: TruncationOptions): {
+    range: Range;
+    truncation: TruncationMetadata;
+};
+export declare function mergeTruncationMetadata(truncations: TruncationMetadata[]): TruncationMetadata;
+//# sourceMappingURL=truncation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"truncation.d.ts","sourceRoot":"","sources":["../../src/util/truncation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;QACzB,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;KACxB,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,CAAE,SAAQ,kBAAkB;IAC3D,KAAK,EAAE,CAAC,EAAE,CAAC;CACZ;AAED,MAAM,WAAW,aAAc,SAAQ,kBAAkB;IACvD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC;IACR,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAQD,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,iBAAiB,GACzB,cAAc,CAAC,CAAC,CAAC,CAsDnB;AAED,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,GACzB,aAAa,CAsDf;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,GACzB,aAAa,CAmDf;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,iBAAiB,GACzB,aAAa,CAgCf;AAED,wBAAgB,aAAa,CAAC,CAAC,EAC7B,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,iBAAiB,GACzB,cAAc,CAAC,CAAC,CAAC,CAWnB;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,GACzB;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,UAAU,EAAE,kBAAkB,CAAA;CAAE,CAgElD;AAED,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,kBAAkB,EAAE,GAChC,kBAAkB,CAWpB"}

package/dist/util/truncation.js

@@ -0,0 +1,259 @@
+function estimateTokens(text) {
+    const words = text.split(/\s+/).filter((w) => w.length > 0);
+    const chars = text.length;
+    return Math.max(words.length, Math.floor(chars / 4));
+}
+export function applyCountTruncation(items, options) {
+    const maxItems = options.maxItems ?? Infinity;
+    if (items.length <= maxItems) {
+        return {
+            items,
+            truncated: false,
+            droppedCount: 0,
+            howToResume: null,
+        };
+    }
+    const preserveFirst = options.preserveFirst ?? 0;
+    const preserveLast = options.preserveLast ?? 0;
+    const truncateAt = options.truncateAt ?? "end";
+    let truncatedItems;
+    let droppedCount;
+    let howToResumeValue;
+    if (truncateAt === "end") {
+        const keepCount = Math.min(maxItems, items.length);
+        truncatedItems = items.slice(0, keepCount);
+        droppedCount = items.length - keepCount;
+        howToResumeValue = keepCount;
+    }
+    else if (truncateAt === "start") {
+        const keepCount = Math.min(maxItems, items.length);
+        truncatedItems = items.slice(-keepCount);
+        droppedCount = items.length - keepCount;
+        howToResumeValue = droppedCount;
+    }
+    else {
+        const firstCount = Math.min(preserveFirst, maxItems / 2);
+        const lastCount = Math.min(preserveLast, maxItems - firstCount);
+        const middleCount = Math.max(0, maxItems - firstCount - lastCount);
+        const firstItems = items.slice(0, firstCount);
+        const lastItems = items.slice(-lastCount);
+        const middleItems = middleCount > 0 ? items.slice(firstCount, firstCount + middleCount) : [];
+        truncatedItems = [...firstItems, ...middleItems, ...lastItems];
+        droppedCount = items.length - truncatedItems.length;
+        howToResumeValue = firstCount + middleCount;
+    }
+    return {
+        items: truncatedItems,
+        truncated: true,
+        droppedCount,
+        howToResume: {
+            type: "cursor",
+            value: howToResumeValue,
+        },
+    };
+}
+export function applyTokenTruncation(text, options) {
+    const maxTokens = options.maxTokens ?? Infinity;
+    const estimatedTokens = estimateTokens(text);
+    if (estimatedTokens <= maxTokens) {
+        return {
+            text,
+            truncated: false,
+            droppedCount: 0,
+            howToResume: null,
+        };
+    }
+    const truncateAt = options.truncateAt ?? "end";
+    const lines = text.split("\n");
+    const avgTokensPerLine = estimatedTokens / lines.length;
+    const maxLines = Math.floor(maxTokens / avgTokensPerLine);
+    let truncatedLines;
+    let droppedCount;
+    if (truncateAt === "end") {
+        truncatedLines = lines.slice(0, Math.max(1, maxLines));
+        droppedCount = lines.length - truncatedLines.length;
+    }
+    else if (truncateAt === "start") {
+        truncatedLines = lines.slice(-Math.max(1, maxLines));
+        droppedCount = lines.length - truncatedLines.length;
+    }
+    else {
+        const preserveFirst = options.preserveFirst ?? 0;
+        const preserveLast = options.preserveLast ?? 0;
+        const firstCount = Math.min(preserveFirst, maxLines / 2);
+        const lastCount = Math.min(preserveLast, maxLines - firstCount);
+        const middleCount = Math.max(0, maxLines - firstCount - lastCount);
+        const firstLines = lines.slice(0, firstCount);
+        const lastLines = lines.slice(-lastCount);
+        const middleLines = middleCount > 0 ? lines.slice(firstCount, firstCount + middleCount) : [];
+        truncatedLines = [...firstLines, ...middleLines, ...lastLines];
+        droppedCount = lines.length - truncatedLines.length;
+    }
+    const truncatedText = truncatedLines.join("\n");
+    return {
+        text: truncatedText,
+        truncated: true,
+        droppedCount,
+        howToResume: {
+            type: "token",
+            value: estimateTokens(truncatedText),
+        },
+    };
+}
+export function applyLineTruncation(text, options) {
+    const maxLines = options.maxLines ?? Infinity;
+    const lines = text.split("\n");
+    if (lines.length <= maxLines) {
+        return {
+            text,
+            truncated: false,
+            droppedCount: 0,
+            howToResume: null,
+        };
+    }
+    const truncateAt = options.truncateAt ?? "end";
+    let truncatedLines;
+    let droppedCount;
+    if (truncateAt === "end") {
+        truncatedLines = lines.slice(0, maxLines);
+        droppedCount = lines.length - maxLines;
+    }
+    else if (truncateAt === "start") {
+        truncatedLines = lines.slice(-maxLines);
+        droppedCount = lines.length - maxLines;
+    }
+    else {
+        const preserveFirst = options.preserveFirst ?? 0;
+        const preserveLast = options.preserveLast ?? 0;
+        const firstCount = Math.min(preserveFirst, maxLines / 2);
+        const lastCount = Math.min(preserveLast, maxLines - firstCount);
+        const middleCount = Math.max(0, maxLines - firstCount - lastCount);
+        const firstLines = lines.slice(0, firstCount);
+        const lastLines = lines.slice(-lastCount);
+        const middleLines = middleCount > 0 ? lines.slice(firstCount, firstCount + middleCount) : [];
+        truncatedLines = [...firstLines, ...middleLines, ...lastLines];
+        droppedCount = lines.length - truncatedLines.length;
+    }
+    const truncatedText = truncatedLines.join("\n");
+    return {
+        text: truncatedText,
+        truncated: true,
+        droppedCount,
+        howToResume: {
+            type: "cursor",
+            value: truncatedLines.length,
+        },
+    };
+}
+export function truncateText(text, options) {
+    if (options.maxTokens !== undefined && options.maxLines !== undefined) {
+        const tokenResult = applyTokenTruncation(text, {
+            ...options,
+            maxLines: undefined,
+        });
+        const lineResult = applyLineTruncation(tokenResult.text, {
+            ...options,
+            maxTokens: undefined,
+        });
+        return {
+            text: lineResult.text,
+            truncated: tokenResult.truncated || lineResult.truncated,
+            droppedCount: tokenResult.droppedCount + lineResult.droppedCount,
+            howToResume: lineResult.howToResume,
+        };
+    }
+    if (options.maxTokens !== undefined) {
+        return applyTokenTruncation(text, options);
+    }
+    if (options.maxLines !== undefined) {
+        return applyLineTruncation(text, options);
+    }
+    return {
+        text,
+        truncated: false,
+        droppedCount: 0,
+        howToResume: null,
+    };
+}
+export function truncateArray(items, options) {
+    if (options.maxItems === undefined) {
+        return {
+            items,
+            truncated: false,
+            droppedCount: 0,
+            howToResume: null,
+        };
+    }
+    return applyCountTruncation(items, options);
+}
+export function truncateRange(range, options) {
+    const lines = range.endLine - range.startLine + 1;
+    const maxLines = options.maxLines ?? Infinity;
+    if (lines <= maxLines) {
+        return {
+            range,
+            truncation: {
+                truncated: false,
+                droppedCount: 0,
+                howToResume: null,
+            },
+        };
+    }
+    const truncateAt = options.truncateAt ?? "end";
+    let truncatedRange;
+    let droppedCount;
+    if (truncateAt === "end") {
+        truncatedRange = {
+            ...range,
+            endLine: range.startLine + maxLines - 1,
+            endCol: 0,
+        };
+        droppedCount = lines - maxLines;
+    }
+    else if (truncateAt === "start") {
+        truncatedRange = {
+            ...range,
+            startLine: range.endLine - maxLines + 1,
+            startCol: 0,
+        };
+        droppedCount = lines - maxLines;
+    }
+    else {
+        const preserveFirst = options.preserveFirst ?? 0;
+        const preserveLast = options.preserveLast ?? 0;
+        const firstCount = Math.min(preserveFirst, maxLines / 2);
+        const lastCount = Math.min(preserveLast, maxLines - firstCount);
+        const middleStart = range.startLine + firstCount;
+        const middleEnd = range.endLine - lastCount;
+        const middleCount = maxLines - firstCount - lastCount;
+        truncatedRange = {
+            startLine: middleStart,
+            startCol: 0,
+            endLine: Math.min(middleStart + middleCount - 1, middleEnd),
+            endCol: 0,
+        };
+        droppedCount = lines - maxLines;
+    }
+    return {
+        range: truncatedRange,
+        truncation: {
+            truncated: true,
+            droppedCount,
+            howToResume: {
+                type: "cursor",
+                value: truncatedRange.endLine,
+            },
+        },
+    };
+}
+export function mergeTruncationMetadata(truncations) {
+    const anyTruncated = truncations.some((t) => t.truncated);
+    const totalDropped = truncations.reduce((sum, t) => sum + t.droppedCount, 0);
+    const lastTruncation = [...truncations].reverse().find((t) => t.truncated);
+    return {
+        truncated: anyTruncated,
+        droppedCount: totalDropped,
+        howToResume: lastTruncation?.howToResume ?? null,
+    };
+}
+//# sourceMappingURL=truncation.js.map

package/dist/util/truncation.js.map

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

package/migrations/.gitkeep

@@ -0,0 +1 @@
+# Placeholders for Git tracking

package/migrations/0001_init.sql

@@ -0,0 +1,61 @@
+PRAGMA journal_mode=WAL;
+PRAGMA synchronous=NORMAL;
+
+CREATE TABLE IF NOT EXISTS repos (
+  repo_id TEXT PRIMARY KEY,
+  root_path TEXT NOT NULL,
+  config_json TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS files (
+  file_id INTEGER PRIMARY KEY AUTOINCREMENT,
+  repo_id TEXT NOT NULL,
+  rel_path TEXT NOT NULL,
+  content_hash TEXT NOT NULL,
+  language TEXT NOT NULL,
+  byte_size INTEGER NOT NULL,
+  last_indexed_at TEXT,
+  UNIQUE(repo_id, rel_path),
+  FOREIGN KEY(repo_id) REFERENCES repos(repo_id)
+);
+
+CREATE TABLE IF NOT EXISTS symbols (
+  symbol_id TEXT PRIMARY KEY,
+  repo_id TEXT NOT NULL,
+  file_id INTEGER NOT NULL,
+  kind TEXT NOT NULL,
+  name TEXT NOT NULL,
+  exported INTEGER NOT NULL,
+  visibility TEXT,
+  range_start_line INTEGER NOT NULL,
+  range_start_col INTEGER NOT NULL,
+  range_end_line INTEGER NOT NULL,
+  range_end_col INTEGER NOT NULL,
+  ast_fingerprint TEXT NOT NULL,
+  signature_json TEXT,
+  summary TEXT,
+  invariants_json TEXT,
+  side_effects_json TEXT,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY(repo_id) REFERENCES repos(repo_id),
+  FOREIGN KEY(file_id) REFERENCES files(file_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_symbols_repo_file ON symbols(repo_id, file_id);
+CREATE INDEX IF NOT EXISTS idx_symbols_repo_name ON symbols(repo_id, name);
+
+CREATE TABLE IF NOT EXISTS edges (
+  edge_id INTEGER PRIMARY KEY AUTOINCREMENT,
+  repo_id TEXT NOT NULL,
+  from_symbol_id TEXT NOT NULL,
+  to_symbol_id TEXT NOT NULL,
+  type TEXT NOT NULL,
+  weight REAL NOT NULL,
+  provenance TEXT,
+  created_at TEXT NOT NULL,
+  FOREIGN KEY(repo_id) REFERENCES repos(repo_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_edges_repo_from ON edges(repo_id, from_symbol_id);
+CREATE INDEX IF NOT EXISTS idx_edges_repo_to ON edges(repo_id, to_symbol_id);

package/migrations/0002_edges_indexes.sql

@@ -0,0 +1,2 @@
+CREATE INDEX IF NOT EXISTS idx_edges_repo_type ON edges(repo_id, type);
+CREATE INDEX IF NOT EXISTS idx_edges_from_to ON edges(from_symbol_id, to_symbol_id);

package/migrations/0003_versions.sql

@@ -0,0 +1,22 @@
+CREATE TABLE IF NOT EXISTS versions (
+  version_id TEXT PRIMARY KEY,
+  repo_id TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  reason TEXT,
+  FOREIGN KEY(repo_id) REFERENCES repos(repo_id)
+);
+
+CREATE TABLE IF NOT EXISTS symbol_versions (
+  version_id TEXT NOT NULL,
+  symbol_id TEXT NOT NULL,
+  ast_fingerprint TEXT NOT NULL,
+  signature_json TEXT,
+  summary TEXT,
+  invariants_json TEXT,
+  side_effects_json TEXT,
+  PRIMARY KEY(version_id, symbol_id),
+  FOREIGN KEY(version_id) REFERENCES versions(version_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_versions_repo ON versions(repo_id, created_at);
+CREATE INDEX IF NOT EXISTS idx_symbol_versions_symbol ON symbol_versions(symbol_id);