@abhinav2203/coderag 0.1.1

package/dist/service/config.d.ts

@@ -0,0 +1,13 @@
+import type { CodeRagConfig, SerializableCodeRagConfig } from "../types.js";
+/**
+ * Loads the serializable CodeRag config from disk and environment overrides.
+ */
+export declare const loadSerializableConfig: (cwd: string, configPath?: string) => Promise<SerializableCodeRagConfig>;
+/**
+ * Resolves the runtime dependencies needed to execute CodeRag.
+ */
+export declare const resolveRuntimeConfig: (config: SerializableCodeRagConfig, cwd: string) => CodeRagConfig;
+/**
+ * Loads and validates the full runtime config for the current working directory.
+ */
+export declare const loadCodeRagConfig: (cwd: string, configPath?: string) => Promise<CodeRagConfig>;

package/dist/service/config.js

@@ -0,0 +1,130 @@
+import path from "node:path";
+import { CodeflowCoreGraphProvider } from "../adapters/codeflow-core.js";
+import { ConfigurationError } from "../errors/index.js";
+import { LocalHashEmbeddingProvider } from "../indexer/embedder.js";
+import { CustomHttpTransport, OpenAiCompatibleTransport } from "../llm/transports.js";
+import { LanceVectorStore } from "../store/vector-store.js";
+import { fileExists, readJson, resolveWithin } from "../utils/filesystem.js";
+import { createConsoleLogger } from "../utils/logger.js";
+import { llmConfigSchema, lockingConfigSchema, serializableConfigSchema, serviceConfigSchema } from "../types.js";
+const CONFIG_FILES = ["coderag.config.json", ".coderag.json"];
+const parseBoolean = (value) => {
+    if (value === undefined) {
+        return undefined;
+    }
+    return value === "1" || value.toLowerCase() === "true";
+};
+const parseNumber = (value) => {
+    if (!value) {
+        return undefined;
+    }
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+};
+const parseJsonRecord = (value) => {
+    if (!value) {
+        return undefined;
+    }
+    const parsed = JSON.parse(value);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new ConfigurationError("CODERAG_LLM_HEADERS must be a JSON object.");
+    }
+    return Object.fromEntries(Object.entries(parsed).map(([key, entryValue]) => [key, String(entryValue)]));
+};
+const resolveConfigPath = async (cwd, configPath) => {
+    if (configPath) {
+        return path.resolve(cwd, configPath);
+    }
+    const existingConfig = await Promise.all(CONFIG_FILES.map(async (candidate) => (await fileExists(path.join(cwd, candidate)) ? candidate : null)));
+    const matchedConfig = existingConfig.find(Boolean);
+    return matchedConfig ? path.resolve(cwd, matchedConfig) : undefined;
+};
+/**
+ * Loads the serializable CodeRag config from disk and environment overrides.
+ */
+export const loadSerializableConfig = async (cwd, configPath) => {
+    const resolvedConfigPath = await resolveConfigPath(cwd, configPath);
+    const baseConfig = resolvedConfigPath
+        ? serializableConfigSchema.parse(await readJson(resolvedConfigPath))
+        : serializableConfigSchema.parse({ repoPath: cwd });
+    const envHeaders = parseJsonRecord(process.env.CODERAG_LLM_HEADERS);
+    return serializableConfigSchema.parse({
+        ...baseConfig,
+        repoPath: process.env.CODERAG_REPO_PATH ?? baseConfig.repoPath,
+        storageRoot: process.env.CODERAG_STORAGE_ROOT ?? baseConfig.storageRoot,
+        retrieval: {
+            ...baseConfig.retrieval,
+            topK: parseNumber(process.env.CODERAG_TOP_K) ?? baseConfig.retrieval.topK,
+            rerankK: parseNumber(process.env.CODERAG_RERANK_K) ?? baseConfig.retrieval.rerankK,
+            maxContextChars: parseNumber(process.env.CODERAG_MAX_CONTEXT_CHARS) ?? baseConfig.retrieval.maxContextChars
+        },
+        traversal: {
+            ...baseConfig.traversal,
+            defaultDepth: parseNumber(process.env.CODERAG_DEFAULT_DEPTH) ?? baseConfig.traversal.defaultDepth,
+            maxDepth: parseNumber(process.env.CODERAG_MAX_DEPTH) ?? baseConfig.traversal.maxDepth
+        },
+        locking: lockingConfigSchema.parse({
+            ...baseConfig.locking,
+            timeoutMs: parseNumber(process.env.CODERAG_LOCK_TIMEOUT_MS) ?? baseConfig.locking.timeoutMs,
+            pollMs: parseNumber(process.env.CODERAG_LOCK_POLL_MS) ?? baseConfig.locking.pollMs,
+            staleMs: parseNumber(process.env.CODERAG_LOCK_STALE_MS) ?? baseConfig.locking.staleMs
+        }),
+        service: serviceConfigSchema.parse({
+            ...baseConfig.service,
+            host: process.env.CODERAG_SERVICE_HOST ?? baseConfig.service.host,
+            port: parseNumber(process.env.CODERAG_SERVICE_PORT) ?? baseConfig.service.port,
+            apiKey: process.env.CODERAG_SERVICE_API_KEY ?? baseConfig.service.apiKey
+        }),
+        llm: llmConfigSchema.parse({
+            ...baseConfig.llm,
+            enabled: parseBoolean(process.env.CODERAG_LLM_ENABLED) ?? baseConfig.llm.enabled,
+            transport: process.env.CODERAG_LLM_TRANSPORT ?? baseConfig.llm.transport,
+            baseUrl: process.env.CODERAG_LLM_BASE_URL ?? baseConfig.llm.baseUrl,
+            model: process.env.CODERAG_LLM_MODEL ?? baseConfig.llm.model,
+            apiKey: process.env.CODERAG_LLM_API_KEY ?? baseConfig.llm.apiKey,
+            timeoutMs: parseNumber(process.env.CODERAG_LLM_TIMEOUT_MS) ?? baseConfig.llm.timeoutMs,
+            customHttpFormat: process.env.CODERAG_CUSTOM_HTTP_FORMAT ?? baseConfig.llm.customHttpFormat,
+            headers: envHeaders ?? baseConfig.llm.headers
+        })
+    });
+};
+/**
+ * Resolves the runtime dependencies needed to execute CodeRag.
+ */
+export const resolveRuntimeConfig = (config, cwd) => {
+    const repoPath = resolveWithin(cwd, config.repoPath);
+    const storageRoot = resolveWithin(repoPath, config.storageRoot);
+    const graphProvider = new CodeflowCoreGraphProvider();
+    const embeddingProvider = new LocalHashEmbeddingProvider();
+    const vectorStore = new LanceVectorStore(storageRoot);
+    const llmTransport = config.llm.enabled && config.llm.baseUrl
+        ? config.llm.transport === "custom-http"
+            ? new CustomHttpTransport(config.llm)
+            : new OpenAiCompatibleTransport(config.llm)
+        : undefined;
+    return {
+        ...config,
+        repoPath,
+        storageRoot,
+        logger: createConsoleLogger(),
+        graphProvider,
+        embeddingProvider,
+        vectorStore,
+        llmTransport
+    };
+};
+/**
+ * Loads and validates the full runtime config for the current working directory.
+ */
+export const loadCodeRagConfig = async (cwd, configPath) => {
+    const serializableConfig = await loadSerializableConfig(cwd, configPath);
+    const runtimeConfig = resolveRuntimeConfig(serializableConfig, cwd);
+    if (runtimeConfig.retrieval.rerankK > runtimeConfig.retrieval.topK) {
+        throw new ConfigurationError("retrieval.rerankK must be less than or equal to retrieval.topK.");
+    }
+    if (runtimeConfig.traversal.defaultDepth > runtimeConfig.traversal.maxDepth) {
+        throw new ConfigurationError("traversal.defaultDepth must be less than or equal to traversal.maxDepth.");
+    }
+    return runtimeConfig;
+};
+//# sourceMappingURL=config.js.map

package/dist/service/config.js.map

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

package/dist/service/http-metrics.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Collects lightweight request metrics for the built-in HTTP service.
+ */
+export declare class HttpMetricsCollector {
+    private readonly metricsByRoute;
+    record(route: string, durationMs: number, isError: boolean): void;
+    render(): string;
+}

package/dist/service/http-metrics.js

@@ -0,0 +1,36 @@
+const formatRouteLabel = (route) => route.replace(/[^a-zA-Z0-9_:]/g, "_");
+/**
+ * Collects lightweight request metrics for the built-in HTTP service.
+ */
+export class HttpMetricsCollector {
+    metricsByRoute = new Map();
+    record(route, durationMs, isError) {
+        const metrics = this.metricsByRoute.get(route) ?? {
+            count: 0,
+            errorCount: 0,
+            totalDurationMs: 0
+        };
+        metrics.count += 1;
+        metrics.errorCount += isError ? 1 : 0;
+        metrics.totalDurationMs += durationMs;
+        this.metricsByRoute.set(route, metrics);
+    }
+    render() {
+        const lines = [
+            "# HELP coderag_http_requests_total Total HTTP requests handled by CodeRag.",
+            "# TYPE coderag_http_requests_total counter",
+            "# HELP coderag_http_request_errors_total Total failed HTTP requests handled by CodeRag.",
+            "# TYPE coderag_http_request_errors_total counter",
+            "# HELP coderag_http_request_duration_ms_total Total request handling time in milliseconds.",
+            "# TYPE coderag_http_request_duration_ms_total counter"
+        ];
+        for (const [route, metrics] of [...this.metricsByRoute.entries()].sort(([left], [right]) => left.localeCompare(right))) {
+            const label = formatRouteLabel(route);
+            lines.push(`coderag_http_requests_total{route="${label}"} ${metrics.count}`);
+            lines.push(`coderag_http_request_errors_total{route="${label}"} ${metrics.errorCount}`);
+            lines.push(`coderag_http_request_duration_ms_total{route="${label}"} ${metrics.totalDurationMs.toFixed(2)}`);
+        }
+        return `${lines.join("\n")}\n`;
+    }
+}
+//# sourceMappingURL=http-metrics.js.map

package/dist/service/http-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-metrics.js","sourceRoot":"","sources":["../../src/service/http-metrics.ts"],"names":[],"mappings":"AAMA,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AAE1F;;GAEG;AACH,MAAM,OAAO,oBAAoB;IACd,cAAc,GAAG,IAAI,GAAG,EAAwB,CAAC;IAElE,MAAM,CAAC,KAAa,EAAE,UAAkB,EAAE,OAAgB;QACxD,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI;YAChD,KAAK,EAAE,CAAC;YACR,UAAU,EAAE,CAAC;YACb,eAAe,EAAE,CAAC;SACnB,CAAC;QACF,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;QACnB,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,OAAO,CAAC,eAAe,IAAI,UAAU,CAAC;QACtC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM;QACJ,MAAM,KAAK,GAAG;YACZ,4EAA4E;YAC5E,4CAA4C;YAC5C,yFAAyF;YACzF,kDAAkD;YAClD,4FAA4F;YAC5F,uDAAuD;SACxD,CAAC;QAEF,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACvH,MAAM,KAAK,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,sCAAsC,KAAK,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;YAC7E,KAAK,CAAC,IAAI,CAAC,4CAA4C,KAAK,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;YACxF,KAAK,CAAC,IAAI,CAAC,iDAAiD,KAAK,MAAM,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/G,CAAC;QAED,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACjC,CAAC;CACF"}

package/dist/service/http.d.ts

@@ -0,0 +1,11 @@
+import http from "node:http";
+import type { CodeRag } from "./coderag.js";
+import type { CodeRagConfig } from "../types.js";
+/**
+ * Creates the built-in HTTP API server for CodeRag.
+ */
+export declare const createHttpServer: (coderag: CodeRag, config: CodeRagConfig) => http.Server;
+/**
+ * Starts the built-in HTTP API server and resolves once it is listening.
+ */
+export declare const serveHttpServer: (coderag: CodeRag, config: CodeRagConfig) => Promise<http.Server>;

package/dist/service/http.js

@@ -0,0 +1,262 @@
+import { randomUUID } from "node:crypto";
+import http from "node:http";
+import { z } from "zod";
+import { CodeRagError, NotFoundError } from "../errors/index.js";
+import { HttpMetricsCollector } from "./http-metrics.js";
+const MAX_REQUEST_BYTES = 1024 * 1024;
+const JSON_CONTENT_TYPE = "application/json";
+const depthSchema = z.number().int().min(0).optional();
+const queryBodySchema = z.object({
+    question: z.string().min(1),
+    depth: depthSchema,
+    includeAnswer: z.boolean().optional()
+});
+const identifierBodySchema = z.object({
+    identifier: z.string().min(1),
+    depth: depthSchema
+});
+const reindexBodySchema = z.object({
+    full: z.boolean().optional()
+});
+const applySecurityHeaders = (request, response) => {
+    response.setHeader("content-security-policy", "default-src 'none'");
+    response.setHeader("x-frame-options", "DENY");
+    response.setHeader("x-content-type-options", "nosniff");
+    response.setHeader("referrer-policy", "no-referrer");
+    response.setHeader("cache-control", "no-store");
+    if ("encrypted" in request.socket && request.socket.encrypted) {
+        response.setHeader("strict-transport-security", "max-age=31536000; includeSubDomains");
+    }
+};
+const writeJson = (request, response, statusCode, requestId, payload) => {
+    applySecurityHeaders(request, response);
+    response.writeHead(statusCode, {
+        "content-type": "application/json; charset=utf-8",
+        "x-request-id": requestId
+    });
+    response.end(`${JSON.stringify(payload)}\n`);
+};
+const writeText = (request, response, statusCode, requestId, payload) => {
+    applySecurityHeaders(request, response);
+    response.writeHead(statusCode, {
+        "content-type": "text/plain; version=0.0.4; charset=utf-8",
+        "x-request-id": requestId
+    });
+    response.end(payload);
+};
+const requiresAuth = (pathname) => pathname.startsWith("/v1/");
+const isAuthorized = (request, apiKey) => {
+    if (!apiKey) {
+        return true;
+    }
+    const authorization = request.headers.authorization;
+    return authorization === `Bearer ${apiKey}`;
+};
+const hasJsonContentType = (request) => {
+    const contentType = request.headers["content-type"];
+    return typeof contentType === "string" && contentType.toLowerCase().includes(JSON_CONTENT_TYPE);
+};
+const readRequestBody = async (request) => {
+    const chunks = [];
+    let totalBytes = 0;
+    for await (const chunk of request) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        totalBytes += buffer.byteLength;
+        if (totalBytes > MAX_REQUEST_BYTES) {
+            throw new CodeRagError("Request body exceeded the maximum allowed size.", "REQUEST_TOO_LARGE");
+        }
+        chunks.push(buffer);
+    }
+    return Buffer.concat(chunks).toString("utf8");
+};
+const readJsonBody = async (request, schema) => {
+    if (!hasJsonContentType(request)) {
+        throw new CodeRagError("Requests must use application/json content-type.", "UNSUPPORTED_MEDIA_TYPE");
+    }
+    const rawBody = await readRequestBody(request);
+    let parsed;
+    try {
+        parsed = JSON.parse(rawBody);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError) {
+            throw new CodeRagError("Request body must contain valid JSON.", "INVALID_REQUEST");
+        }
+        throw error;
+    }
+    return schema.parse(parsed);
+};
+const errorStatusCode = (error) => {
+    if (error instanceof NotFoundError) {
+        return 404;
+    }
+    if (error instanceof z.ZodError) {
+        return 400;
+    }
+    if (error instanceof CodeRagError) {
+        if (error.code === "UNSUPPORTED_MEDIA_TYPE") {
+            return 415;
+        }
+        if (error.code === "REQUEST_TOO_LARGE") {
+            return 413;
+        }
+        return 400;
+    }
+    return 500;
+};
+const errorResponse = (error) => {
+    if (error instanceof z.ZodError) {
+        return {
+            code: "INVALID_REQUEST",
+            message: "Request validation failed.",
+            details: error.flatten()
+        };
+    }
+    if (error instanceof CodeRagError) {
+        return {
+            code: error.code,
+            message: error.message,
+            details: error.details
+        };
+    }
+    return {
+        code: "INTERNAL_SERVER_ERROR",
+        message: "An error occurred."
+    };
+};
+const createQueryHandler = (coderag) => async (request, response, requestId) => {
+    const body = await readJsonBody(request, queryBodySchema);
+    const result = await coderag.query(body.question, {
+        depth: body.depth,
+        includeAnswer: body.includeAnswer
+    });
+    writeJson(request, response, 200, requestId, { data: result, requestId });
+};
+const createLookupHandler = (coderag) => async (request, response, requestId) => {
+    const body = await readJsonBody(request, identifierBodySchema.pick({ identifier: true }));
+    writeJson(request, response, 200, requestId, { data: await coderag.lookup(body.identifier), requestId });
+};
+const createExplainHandler = (coderag) => async (request, response, requestId) => {
+    const body = await readJsonBody(request, identifierBodySchema);
+    writeJson(request, response, 200, requestId, { data: await coderag.explain(body.identifier, body.depth), requestId });
+};
+const createImpactHandler = (coderag) => async (request, response, requestId) => {
+    const body = await readJsonBody(request, identifierBodySchema);
+    writeJson(request, response, 200, requestId, { data: await coderag.impact(body.identifier, body.depth), requestId });
+};
+const createIndexHandler = (coderag) => async (request, response, requestId) => {
+    const body = await readJsonBody(request, reindexBodySchema);
+    const result = body.full ? await coderag.index() : await coderag.reindex({ full: false });
+    writeJson(request, response, 200, requestId, { data: result, requestId });
+};
+const createReindexHandler = (coderag) => async (request, response, requestId) => {
+    const body = await readJsonBody(request, reindexBodySchema);
+    writeJson(request, response, 200, requestId, {
+        data: await coderag.reindex({ full: body.full }),
+        requestId
+    });
+};
+const createStatusHandler = (coderag) => async (request, response, requestId) => {
+    writeJson(request, response, 200, requestId, { data: await coderag.status(), requestId });
+};
+const createHealthHandler = (coderag) => async (request, response, requestId) => {
+    writeJson(request, response, 200, requestId, { data: { ok: true, status: await coderag.status() }, requestId });
+};
+const createReadyHandler = (coderag) => async (request, response, requestId) => {
+    const status = await coderag.status();
+    writeJson(request, response, 200, requestId, {
+        data: { ready: true, status },
+        requestId
+    });
+};
+const createMetricsHandler = (metrics) => async (request, response, requestId) => {
+    writeText(request, response, 200, requestId, metrics.render());
+};
+const notFoundHandler = async (request, response, requestId) => {
+    writeJson(request, response, 404, requestId, {
+        error: {
+            code: "NOT_FOUND",
+            message: "The requested route does not exist."
+        },
+        requestId
+    });
+};
+const getRouteHandler = (coderag, metrics) => new Map([
+    ["POST /v1/query", createQueryHandler(coderag)],
+    ["POST /v1/lookup", createLookupHandler(coderag)],
+    ["POST /v1/explain", createExplainHandler(coderag)],
+    ["POST /v1/impact", createImpactHandler(coderag)],
+    ["POST /v1/index", createIndexHandler(coderag)],
+    ["POST /v1/reindex", createReindexHandler(coderag)],
+    ["GET /v1/status", createStatusHandler(coderag)],
+    ["GET /health", createHealthHandler(coderag)],
+    ["GET /healthz", createHealthHandler(coderag)],
+    ["GET /ready", createReadyHandler(coderag)],
+    ["GET /readyz", createReadyHandler(coderag)],
+    ["GET /metrics", createMetricsHandler(metrics)]
+]);
+const createRouteKey = (method, pathname) => `${method ?? "GET"} ${pathname}`;
+/**
+ * Creates the built-in HTTP API server for CodeRag.
+ */
+export const createHttpServer = (coderag, config) => {
+    const metrics = new HttpMetricsCollector();
+    const routeHandlers = getRouteHandler(coderag, metrics);
+    return http.createServer(async (request, response) => {
+        const requestId = randomUUID();
+        const startTime = Date.now();
+        const url = new URL(request.url ?? "/", "http://127.0.0.1");
+        const routeKey = createRouteKey(request.method, url.pathname);
+        const routeHandler = routeHandlers.get(routeKey) ?? notFoundHandler;
+        try {
+            if (requiresAuth(url.pathname) && !isAuthorized(request, config.service.apiKey)) {
+                writeJson(request, response, 401, requestId, {
+                    error: {
+                        code: "UNAUTHORIZED",
+                        message: "Missing or invalid bearer token."
+                    },
+                    requestId
+                });
+                metrics.record(routeKey, Date.now() - startTime, true);
+                return;
+            }
+            await routeHandler(request, response, requestId);
+            metrics.record(routeKey, Date.now() - startTime, false);
+        }
+        catch (error) {
+            const statusCode = errorStatusCode(error);
+            const serializedError = errorResponse(error);
+            config.logger?.error("CodeRag HTTP request failed.", {
+                requestId,
+                method: request.method,
+                pathname: url.pathname,
+                statusCode,
+                errorCode: serializedError.code
+            });
+            writeJson(request, response, statusCode, requestId, {
+                error: serializedError,
+                requestId
+            });
+            metrics.record(routeKey, Date.now() - startTime, true);
+        }
+    });
+};
+/**
+ * Starts the built-in HTTP API server and resolves once it is listening.
+ */
+export const serveHttpServer = async (coderag, config) => {
+    const server = createHttpServer(coderag, config);
+    await new Promise((resolve, reject) => {
+        server.once("error", reject);
+        server.listen(config.service.port, config.service.host, () => {
+            server.off("error", reject);
+            config.logger?.info("CodeRag HTTP server started.", {
+                host: config.service.host,
+                port: config.service.port
+            });
+            resolve();
+        });
+    });
+    return server;
+};
+//# sourceMappingURL=http.js.map

package/dist/service/http.js.map

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

package/dist/store/file-cache.d.ts

@@ -0,0 +1,6 @@
+export declare class FileCache {
+    private readonly cache;
+    read(filePath: string): Promise<string>;
+    invalidate(filePath: string): void;
+    clear(): void;
+}

package/dist/store/file-cache.js

@@ -0,0 +1,24 @@
+import fs from "node:fs/promises";
+export class FileCache {
+    cache = new Map();
+    async read(filePath) {
+        const stats = await fs.stat(filePath);
+        const cached = this.cache.get(filePath);
+        if (cached && cached.mtimeMs === stats.mtimeMs) {
+            return cached.content;
+        }
+        const content = await fs.readFile(filePath, "utf8");
+        this.cache.set(filePath, {
+            content,
+            mtimeMs: stats.mtimeMs
+        });
+        return content;
+    }
+    invalidate(filePath) {
+        this.cache.delete(filePath);
+    }
+    clear() {
+        this.cache.clear();
+    }
+}
+//# sourceMappingURL=file-cache.js.map

package/dist/store/file-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-cache.js","sourceRoot":"","sources":["../../src/store/file-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAOlC,MAAM,OAAO,SAAS;IACH,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAEvD,KAAK,CAAC,IAAI,CAAC,QAAgB;QACzB,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAExC,IAAI,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;YAC/C,OAAO,MAAM,CAAC,OAAO,CAAC;QACxB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE;YACvB,OAAO;YACP,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/store/index-lock.d.ts

@@ -0,0 +1,14 @@
+import type { LockingConfig, Logger } from "../types.js";
+/**
+ * Coordinates access to the shared on-disk index state across processes.
+ */
+export declare class IndexLock {
+    private readonly config;
+    private readonly logger?;
+    private readonly lockFilePath;
+    constructor(storageRoot: string, config: LockingConfig, logger?: Logger | undefined);
+    withLock<Value>(reason: string, action: () => Promise<Value>): Promise<Value>;
+    waitForRelease(): Promise<boolean>;
+    private acquire;
+    private clearStaleLock;
+}