@abhinav2203/coderag 0.1.1

package/dist/cli.js

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+import { installPostCommitHook } from "./indexer/git-hook.js";
+import { createCodeRag, loadCodeRagConfig } from "./index.js";
+import { serveStdioMcpServer } from "./mcp/server.js";
+import { serveHttpServer } from "./service/http.js";
+const JSON_FLAG = "--json";
+const FLAGS_WITH_VALUES = new Set(["--config", "--depth"]);
+const printUsage = () => {
+    console.log(`Usage:
+  coderag init [--config path] [--json]
+  coderag index [--config path] [--json]
+  coderag reindex [--config path] [--full] [--json]
+  coderag query "question" [--config path] [--depth 2] [--json]
+  coderag serve-mcp [--config path]
+  coderag serve-http [--config path]
+  coderag doctor [--config path] [--json]`);
+};
+const readFlagValue = (args, flag) => {
+    const index = args.indexOf(flag);
+    return index === -1 ? undefined : args[index + 1];
+};
+const hasFlag = (args, flag) => args.includes(flag);
+const readPositionals = (args) => {
+    const positionals = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const argument = args[index];
+        if (!argument) {
+            continue;
+        }
+        if (argument.startsWith("--")) {
+            if (FLAGS_WITH_VALUES.has(argument)) {
+                index += 1;
+            }
+            continue;
+        }
+        positionals.push(argument);
+    }
+    return positionals;
+};
+const printJson = (value) => {
+    console.log(JSON.stringify(value, null, 2));
+};
+const printIndexSummary = (label, indexedNodeCount, storageRoot) => {
+    console.log(`${label}: indexed ${indexedNodeCount} nodes into ${storageRoot}`);
+};
+const printDoctorStatus = (status) => {
+    console.log(`indexed: ${status.indexed ? "yes" : "no"}`);
+    console.log(`indexedNodeCount: ${status.indexedNodeCount}`);
+    console.log(`generatedAt: ${status.generatedAt ?? "never"}`);
+    console.log(`repoPath: ${status.repoPath}`);
+    console.log(`storageRoot: ${status.storageRoot}`);
+    console.log(`provider: ${status.provider ?? "unknown"}`);
+    console.log(`llmEnabled: ${status.llmEnabled ? "yes" : "no"}`);
+};
+const waitForTermination = async (server) => {
+    await new Promise((resolve, reject) => {
+        const shutdown = () => {
+            server.close((error) => {
+                if (error) {
+                    reject(error);
+                    return;
+                }
+                resolve();
+            });
+        };
+        process.once("SIGINT", shutdown);
+        process.once("SIGTERM", shutdown);
+    });
+};
+export const runCli = async (argv = process.argv) => {
+    const [, , command, ...args] = argv;
+    if (!command) {
+        printUsage();
+        process.exitCode = 1;
+        return;
+    }
+    const configPath = readFlagValue(args, "--config");
+    const config = await loadCodeRagConfig(process.cwd(), configPath);
+    const coderag = createCodeRag(config);
+    try {
+        if (command === "init") {
+            const summary = await coderag.index();
+            await installPostCommitHook(config.repoPath, configPath ?? null, config.logger);
+            if (hasFlag(args, JSON_FLAG)) {
+                printJson({ ok: true, indexedNodeCount: summary.indexedNodeCount, storageRoot: config.storageRoot });
+            }
+            else {
+                printIndexSummary("initialized", summary.indexedNodeCount, config.storageRoot);
+            }
+            return;
+        }
+        if (command === "index") {
+            const summary = await coderag.index();
+            if (hasFlag(args, JSON_FLAG)) {
+                printJson(summary);
+            }
+            else {
+                printIndexSummary("indexed", summary.indexedNodeCount, config.storageRoot);
+            }
+            return;
+        }
+        if (command === "reindex") {
+            const summary = await coderag.reindex({ full: hasFlag(args, "--full") });
+            if (hasFlag(args, JSON_FLAG)) {
+                printJson(summary);
+            }
+            else {
+                printIndexSummary(hasFlag(args, "--full") ? "full reindex completed" : "reindex completed", summary.indexedNodeCount, config.storageRoot);
+            }
+            return;
+        }
+        if (command === "query") {
+            const question = readPositionals(args)[0];
+            if (!question) {
+                throw new Error("query requires a question argument.");
+            }
+            const depthValue = readFlagValue(args, "--depth");
+            const depth = depthValue ? Number(depthValue) : undefined;
+            const result = await coderag.query(question, {
+                depth,
+                onToken: hasFlag(args, JSON_FLAG)
+                    ? undefined
+                    : (token) => {
+                        process.stdout.write(token);
+                    }
+            });
+            if (hasFlag(args, JSON_FLAG)) {
+                printJson(result);
+            }
+            else if (result.answerMode === "context-only") {
+                console.log(result.answer);
+            }
+            else {
+                process.stdout.write("\n");
+            }
+            return;
+        }
+        if (command === "serve-mcp") {
+            await serveStdioMcpServer(coderag);
+            return;
+        }
+        if (command === "serve-http") {
+            const server = await serveHttpServer(coderag, config);
+            await waitForTermination(server);
+            return;
+        }
+        if (command === "doctor") {
+            const status = await coderag.status();
+            if (hasFlag(args, JSON_FLAG)) {
+                printJson(status);
+            }
+            else {
+                printDoctorStatus(status);
+            }
+            return;
+        }
+        printUsage();
+        process.exitCode = 1;
+    }
+    finally {
+        await coderag.close();
+    }
+};
+export const exitWithCliError = (error) => {
+    const message = error instanceof Error ? error.stack ?? error.message : String(error);
+    console.error(message);
+    process.exit(1);
+};
+const runAsMain = process.argv[1] ? fileURLToPath(import.meta.url) === process.argv[1] : false;
+export const maybeRunCli = () => {
+    if (!runAsMain) {
+        return undefined;
+    }
+    return runCli().catch(exitWithCliError);
+};
+void maybeRunCli();
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/errors/index.d.ts

@@ -0,0 +1,17 @@
+export declare class CodeRagError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, unknown>;
+    constructor(message: string, code?: string, details?: Record<string, unknown>, options?: ErrorOptions);
+}
+export declare class ConfigurationError extends CodeRagError {
+    constructor(message: string, details?: Record<string, unknown>, options?: ErrorOptions);
+}
+export declare class IndexingError extends CodeRagError {
+    constructor(message: string, details?: Record<string, unknown>, options?: ErrorOptions);
+}
+export declare class TransportError extends CodeRagError {
+    constructor(message: string, details?: Record<string, unknown>, options?: ErrorOptions);
+}
+export declare class NotFoundError extends CodeRagError {
+    constructor(message: string, details?: Record<string, unknown>, options?: ErrorOptions);
+}

package/dist/errors/index.js

@@ -0,0 +1,35 @@
+export class CodeRagError extends Error {
+    code;
+    details;
+    constructor(message, code = "CODERAG_ERROR", details, options) {
+        super(message, options);
+        this.name = "CodeRagError";
+        this.code = code;
+        this.details = details;
+    }
+}
+export class ConfigurationError extends CodeRagError {
+    constructor(message, details, options) {
+        super(message, "CONFIGURATION_ERROR", details, options);
+        this.name = "ConfigurationError";
+    }
+}
+export class IndexingError extends CodeRagError {
+    constructor(message, details, options) {
+        super(message, "INDEXING_ERROR", details, options);
+        this.name = "IndexingError";
+    }
+}
+export class TransportError extends CodeRagError {
+    constructor(message, details, options) {
+        super(message, "TRANSPORT_ERROR", details, options);
+        this.name = "TransportError";
+    }
+}
+export class NotFoundError extends CodeRagError {
+    constructor(message, details, options) {
+        super(message, "NOT_FOUND", details, options);
+        this.name = "NotFoundError";
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,YAAa,SAAQ,KAAK;IAC5B,IAAI,CAAS;IACb,OAAO,CAA2B;IAE3C,YAAY,OAAe,EAAE,IAAI,GAAG,eAAe,EAAE,OAAiC,EAAE,OAAsB;QAC5G,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAClD,YAAY,OAAe,EAAE,OAAiC,EAAE,OAAsB;QACpF,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,YAAY;IAC7C,YAAY,OAAe,EAAE,OAAiC,EAAE,OAAsB;QACpF,KAAK,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,YAAY;IAC9C,YAAY,OAAe,EAAE,OAAiC,EAAE,OAAsB;QACpF,KAAK,CAAC,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,YAAY;IAC7C,YAAY,OAAe,EAAE,OAAiC,EAAE,OAAsB;QACpF,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import type { CodeRagConfig } from "./types.js";
+import { CodeRag } from "./service/coderag.js";
+export { CodeRag } from "./service/coderag.js";
+export { CodeflowCoreGraphProvider, buildGraphSnapshot } from "./adapters/codeflow-core.js";
+export { loadCodeRagConfig, loadSerializableConfig, resolveRuntimeConfig } from "./service/config.js";
+export { createHttpServer, serveHttpServer } from "./service/http.js";
+export { LocalHashEmbeddingProvider } from "./indexer/embedder.js";
+export { LanceVectorStore } from "./store/vector-store.js";
+export { createMcpServer, serveStdioMcpServer } from "./mcp/server.js";
+export * from "./errors/index.js";
+export * from "./types.js";
+/**
+ * Creates a CodeRag service instance for the supplied runtime config.
+ */
+export declare const createCodeRag: (config: CodeRagConfig) => CodeRag;

package/dist/index.js

@@ -0,0 +1,15 @@
+import { CodeRag } from "./service/coderag.js";
+export { CodeRag } from "./service/coderag.js";
+export { CodeflowCoreGraphProvider, buildGraphSnapshot } from "./adapters/codeflow-core.js";
+export { loadCodeRagConfig, loadSerializableConfig, resolveRuntimeConfig } from "./service/config.js";
+export { createHttpServer, serveHttpServer } from "./service/http.js";
+export { LocalHashEmbeddingProvider } from "./indexer/embedder.js";
+export { LanceVectorStore } from "./store/vector-store.js";
+export { createMcpServer, serveStdioMcpServer } from "./mcp/server.js";
+export * from "./errors/index.js";
+export * from "./types.js";
+/**
+ * Creates a CodeRag service instance for the supplied runtime config.
+ */
+export const createCodeRag = (config) => new CodeRag(config);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACtG,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACtE,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACvE,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAE3B;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,MAAqB,EAAW,EAAE,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC"}

package/dist/indexer/documents.d.ts

@@ -0,0 +1,16 @@
+import type { BlueprintNode } from "@abhinav2203/codeflow-core/schema";
+import type { EmbeddingProvider, GraphSnapshot, IndexManifest, IndexedNodeDocument, SourceSpan } from "../types.js";
+/**
+ * Builds the natural-language search document stored for a blueprint node.
+ */
+export declare const buildNodeDocument: (node: BlueprintNode, span: SourceSpan | undefined, snapshot: GraphSnapshot) => string;
+/**
+ * Embeds graph-node documents so they can be searched and reranked later.
+ * If docsPath is provided, reads markdown files from that directory (named by node ID)
+ * and uses their content as the embedding text instead of generating thin markdown.
+ */
+export declare const buildIndexedDocuments: (snapshot: GraphSnapshot, embeddingProvider: EmbeddingProvider, docsPath?: string) => Promise<Record<string, IndexedNodeDocument>>;
+/**
+ * Builds the manifest used for incremental reindex decisions.
+ */
+export declare const buildIndexManifest: (repoPath: string, snapshot: GraphSnapshot, documents: Record<string, IndexedNodeDocument>) => Promise<IndexManifest>;

package/dist/indexer/documents.js

@@ -0,0 +1,148 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { hashContent, hashFile } from "../utils/filesystem.js";
+/**
+ * Reads the markdown document for a node from the external docsPath.
+ * Files are matched by node ID: `${docsPath}/${nodeId}.md`
+ */
+const readExternalNodeDoc = async (nodeId, docsPath) => {
+    const docFilePath = path.join(docsPath, `${nodeId}.md`);
+    try {
+        return await fs.readFile(docFilePath, "utf8");
+    }
+    catch {
+        return null;
+    }
+};
+const EMPTY_LIST = "- None";
+const formatList = (items) => (items.length > 0 ? items.map((item) => `- ${item}`).join("\n") : EMPTY_LIST);
+const formatFieldList = (fields) => {
+    if (fields.length === 0) {
+        return EMPTY_LIST;
+    }
+    return fields
+        .map((field) => `- ${field.name}: ${field.type}${field.description ? ` - ${field.description}` : ""}`)
+        .join("\n");
+};
+const findRelatedNode = (currentNodeId, edge, graphNodes) => {
+    const relatedNodeId = edge.from === currentNodeId ? edge.to : edge.from;
+    return graphNodes.find((node) => node.id === relatedNodeId);
+};
+const summarizeEdges = (currentNodeId, edges, graphNodes) => edges.map((edge) => {
+    const relatedNode = findRelatedNode(currentNodeId, edge, graphNodes);
+    const relatedLabel = relatedNode?.path ? `${relatedNode.name} (${relatedNode.path})` : relatedNode?.name ?? edge.to;
+    return `${edge.kind}: ${relatedLabel}`;
+});
+const formatSourceRefs = (node) => formatList(node.sourceRefs.map((sourceRef) => `${sourceRef.kind}${sourceRef.symbol ? `:${sourceRef.symbol}` : ""}${sourceRef.path ? ` @ ${sourceRef.path}` : ""}`));
+const buildHeader = (node, span) => [
+    `# ${node.name}`,
+    "",
+    `Kind: ${node.kind}`,
+    `Path: ${node.path ?? "unknown"}`,
+    `File Name: ${node.path ? path.basename(node.path) : "unknown"}`,
+    `Lines: ${span ? `${span.startLine}-${span.endLine}` : "unknown"}`,
+    `Signature: ${node.signature ?? "N/A"}`
+];
+const readSourceText = async (repoPath, span) => {
+    const fileContent = await fs.readFile(path.join(repoPath, span.filePath), "utf8");
+    return fileContent.split(/\r?\n/).slice(span.startLine - 1, span.endLine).join("\n");
+};
+/**
+ * Builds the natural-language search document stored for a blueprint node.
+ */
+export const buildNodeDocument = (node, span, snapshot) => {
+    const outgoingEdges = snapshot.graph.edges.filter((edge) => edge.from === node.id);
+    const incomingEdges = snapshot.graph.edges.filter((edge) => edge.to === node.id);
+    return [
+        ...buildHeader(node, span),
+        "",
+        "Summary:",
+        node.summary,
+        "",
+        "Responsibilities:",
+        formatList(node.contract.responsibilities),
+        "",
+        "Inputs:",
+        formatFieldList(node.contract.inputs),
+        "",
+        "Outputs:",
+        formatFieldList(node.contract.outputs),
+        "",
+        "Declared Dependencies:",
+        formatList(node.contract.dependencies),
+        "",
+        "Source References:",
+        formatSourceRefs(node),
+        "",
+        "Calls:",
+        formatList(summarizeEdges(node.id, outgoingEdges, snapshot.graph.nodes)),
+        "",
+        "Called By:",
+        formatList(summarizeEdges(node.id, incomingEdges, snapshot.graph.nodes))
+    ].join("\n");
+};
+/**
+ * Embeds graph-node documents so they can be searched and reranked later.
+ * If docsPath is provided, reads markdown files from that directory (named by node ID)
+ * and uses their content as the embedding text instead of generating thin markdown.
+ */
+export const buildIndexedDocuments = async (snapshot, embeddingProvider, docsPath) => {
+    const documents = {};
+    for (const node of snapshot.graph.nodes) {
+        const span = snapshot.sourceSpans[node.id];
+        if (!node.path || !span) {
+            continue;
+        }
+        const doc = buildNodeDocument(node, span, snapshot);
+        const sourceText = await readSourceText(snapshot.repoPath, span).catch(() => "");
+        let embeddingText;
+        if (docsPath) {
+            const externalDoc = await readExternalNodeDoc(node.id, docsPath);
+            embeddingText = externalDoc ?? [doc, sourceText].filter(Boolean).join("\n\n");
+        }
+        else {
+            embeddingText = [doc, sourceText].filter(Boolean).join("\n\n");
+        }
+        documents[node.id] = {
+            nodeId: node.id,
+            name: node.name,
+            kind: node.kind,
+            filePath: node.path,
+            summary: node.summary,
+            signature: node.signature ?? "",
+            doc,
+            sourceText,
+            vector: await embeddingProvider.embed(embeddingText),
+            startLine: span.startLine,
+            endLine: span.endLine
+        };
+    }
+    return documents;
+};
+const hashIndexedFile = async (repoPath, relativePath) => [
+    relativePath,
+    await hashFile(path.join(repoPath, relativePath))
+];
+/**
+ * Builds the manifest used for incremental reindex decisions.
+ */
+export const buildIndexManifest = async (repoPath, snapshot, documents) => {
+    const uniquePaths = [...new Set(Object.values(documents).map((document) => document.filePath))];
+    const fileHashes = Object.fromEntries(await Promise.all(uniquePaths.map((relativePath) => hashIndexedFile(repoPath, relativePath))));
+    return {
+        generatedAt: new Date().toISOString(),
+        repoPath: snapshot.repoPath,
+        provider: snapshot.provider,
+        nodes: Object.fromEntries(Object.values(documents).map((document) => [
+            document.nodeId,
+            {
+                nodeId: document.nodeId,
+                filePath: document.filePath,
+                docHash: hashContent(document.doc),
+                fileHash: fileHashes[document.filePath]
+            }
+        ])),
+        fileHashes
+    };
+};
+//# sourceMappingURL=documents.js.map

package/dist/indexer/documents.js.map

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

package/dist/indexer/embedder.d.ts

@@ -0,0 +1,7 @@
+import type { EmbeddingProvider } from "../types.js";
+export declare class LocalHashEmbeddingProvider implements EmbeddingProvider {
+    readonly name = "local-hash";
+    readonly dimensions: number;
+    constructor(dimensions?: number);
+    embed(text: string): Promise<number[]>;
+}

package/dist/indexer/embedder.js

@@ -0,0 +1,12 @@
+import { embedTextDeterministically } from "../utils/text.js";
+export class LocalHashEmbeddingProvider {
+    name = "local-hash";
+    dimensions;
+    constructor(dimensions = 256) {
+        this.dimensions = dimensions;
+    }
+    async embed(text) {
+        return embedTextDeterministically(text, this.dimensions);
+    }
+}
+//# sourceMappingURL=embedder.js.map

package/dist/indexer/embedder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.js","sourceRoot":"","sources":["../../src/indexer/embedder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE9D,MAAM,OAAO,0BAA0B;IAC5B,IAAI,GAAG,YAAY,CAAC;IACpB,UAAU,CAAS;IAE5B,YAAY,UAAU,GAAG,GAAG;QAC1B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,OAAO,0BAA0B,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/indexer/git-hook.d.ts

@@ -0,0 +1,2 @@
+import type { Logger } from "../types.js";
+export declare const installPostCommitHook: (repoPath: string, configPath: string | null, logger?: Logger) => Promise<void>;

package/dist/indexer/git-hook.js

@@ -0,0 +1,53 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { ensureDir } from "../utils/filesystem.js";
+const HOOK_MARKER = "# Added by CodeRag";
+const resolveGitDir = async (repoPath) => {
+    const dotGitPath = path.join(repoPath, ".git");
+    const stats = await fs.stat(dotGitPath).catch(() => null);
+    if (!stats) {
+        return null;
+    }
+    if (stats.isDirectory()) {
+        return dotGitPath;
+    }
+    const content = await fs.readFile(dotGitPath, "utf8");
+    const match = content.match(/gitdir:\s*(.+)\s*/i);
+    if (!match?.[1]) {
+        return null;
+    }
+    return path.resolve(repoPath, match[1]);
+};
+export const installPostCommitHook = async (repoPath, configPath, logger) => {
+    const gitDir = await resolveGitDir(repoPath);
+    if (!gitDir) {
+        logger?.warn("Skipped git hook installation because no Git directory was found.", {
+            repoPath
+        });
+        return;
+    }
+    const hooksDir = path.join(gitDir, "hooks");
+    const hookPath = path.join(hooksDir, "post-commit");
+    const backupHookPath = path.join(hooksDir, "post-commit.coderag.previous");
+    await ensureDir(hooksDir);
+    const existingHook = await fs.readFile(hookPath, "utf8").catch(() => "");
+    if (existingHook.includes(HOOK_MARKER)) {
+        return;
+    }
+    if (existingHook.trim()) {
+        await fs.writeFile(backupHookPath, existingHook, "utf8");
+    }
+    const configArgument = configPath ? ` --config "${configPath}"` : "";
+    const script = `#!/bin/sh
+${HOOK_MARKER}
+set -e
+if [ -f "${backupHookPath}" ]; then
+  sh "${backupHookPath}"
+fi
+if command -v npx >/dev/null 2>&1; then
+  npx --no-install coderag reindex${configArgument} >/dev/null 2>&1 || true
+fi
+`;
+    await fs.writeFile(hookPath, script, { mode: 0o755 });
+};
+//# sourceMappingURL=git-hook.js.map

package/dist/indexer/git-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-hook.js","sourceRoot":"","sources":["../../src/indexer/git-hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEzC,MAAM,aAAa,GAAG,KAAK,EAAE,QAAgB,EAA0B,EAAE;IACvE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QACxB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;IAClD,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,EACxC,QAAgB,EAChB,UAAyB,EACzB,MAAe,EACA,EAAE;IACjB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,EAAE,IAAI,CAAC,mEAAmE,EAAE;YAChF,QAAQ;SACT,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACpD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,8BAA8B,CAAC,CAAC;IAC3E,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE1B,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IACzE,IAAI,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACvC,OAAO;IACT,CAAC;IAED,IAAI,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC;QACxB,MAAM,EAAE,CAAC,SAAS,CAAC,cAAc,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,cAAc,GAAG,UAAU,CAAC,CAAC,CAAC,cAAc,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACrE,MAAM,MAAM,GAAG;EACf,WAAW;;WAEF,cAAc;QACjB,cAAc;;;oCAGc,cAAc;;CAEjD,CAAC;IAEA,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACxD,CAAC,CAAC"}

package/dist/indexer/indexer.d.ts

@@ -0,0 +1,22 @@
+import type { CodeRagConfig, GraphSnapshot, IndexManifest, IndexSummary, IndexedNodeDocument } from "../types.js";
+/**
+ * Indexes the repository graph and persists the resulting search documents.
+ */
+export declare class RepoIndexer {
+    private readonly config;
+    private readonly manifestStore;
+    private readonly indexLock;
+    constructor(config: CodeRagConfig);
+    loadState(): Promise<{
+        manifest: IndexManifest | null;
+        snapshot: GraphSnapshot | null;
+        documents: Record<string, IndexedNodeDocument>;
+    }>;
+    waitForUnlockedState(): Promise<{
+        waited: boolean;
+        manifest: IndexManifest | null;
+        snapshot: GraphSnapshot | null;
+        documents: Record<string, IndexedNodeDocument>;
+    }>;
+    index(forceFull?: boolean, docsPath?: string): Promise<IndexSummary>;
+}