codesearch-mcp 0.0.17-alpha.1 → 0.0.18-alpha

package/dist/src/config-store.js

@@ -33,9 +33,12 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ALL_KEYS = exports.CONFIG_FILE = exports.CONFIG_DIR = void 0;
+exports.CONFIG_DEFAULTS = exports.ALL_KEYS = exports.SCHEMA_FILE = exports.CONFIG_FILE = exports.CONFIG_DIR = void 0;
 exports.readConfigJson = readConfigJson;
+exports.parseConfig = parseConfig;
+exports.buildJsonSchema = buildJsonSchema;
 exports.writeConfigJson = writeConfigJson;
+exports.writeSchemaFile = writeSchemaFile;
 exports.getNestedValue = getNestedValue;
 exports.setNestedValue = setNestedValue;
 exports.deleteNestedValue = deleteNestedValue;
@@ -43,45 +46,51 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const zod_1 = require("zod");
+const constants_1 = require("./constants");
 exports.CONFIG_DIR = path.join(os.homedir(), '.config', 'codesearch-mcp');
 exports.CONFIG_FILE = path.join(exports.CONFIG_DIR, 'config.json');
+exports.SCHEMA_FILE = path.join(exports.CONFIG_DIR, 'config.schema.json');
+// Relative $schema reference written into config.json so editors resolve the
+// sibling schema file for autocomplete / inline validation.
+const SCHEMA_REF = './config.schema.json';
 // All fields optional — defaults live in config.ts. The file stays minimal.
+// Descriptions surface as tooltips in schema-aware editors (VS Code, JetBrains).
 const jsonSchema = zod_1.z.object({
     db: zod_1.z.object({
-        host: zod_1.z.string().optional(),
-        port: zod_1.z.number().optional(),
-        user: zod_1.z.string().optional(),
-        password: zod_1.z.string().optional(),
-        name: zod_1.z.string().optional(),
+        host: zod_1.z.string().describe('PostgreSQL host').optional(),
+        port: zod_1.z.number().int().describe('PostgreSQL port (default 5433)').optional(),
+        user: zod_1.z.string().describe('PostgreSQL user').optional(),
+        password: zod_1.z.string().describe('PostgreSQL password').optional(),
+        name: zod_1.z.string().describe('Database name; defaults to rag_<os-username>, auto-created on first run').optional(),
     }).optional(),
     ollama: zod_1.z.object({
-        host: zod_1.z.string().optional(),
-        model: zod_1.z.string().optional(),
+        host: zod_1.z.string().describe('Ollama API URL (default http://localhost:11434)').optional(),
+        model: zod_1.z.string().describe('Embedding model (default bge-m3)').optional(),
     }).optional(),
     indexing: zod_1.z.object({
-        chunkSize: zod_1.z.number().optional(),
-        chunkOverlap: zod_1.z.number().optional(),
-        embedBatchSize: zod_1.z.number().optional(),
-        astBatchSize: zod_1.z.number().optional(),
+        chunkSize: zod_1.z.number().int().describe('Max chars per chunk (default 1500)').optional(),
+        chunkOverlap: zod_1.z.number().int().describe('Overlap between chunks (default 200)').optional(),
+        embedBatchSize: zod_1.z.number().int().describe('Parallel embeddings per batch (default 5)').optional(),
+        astBatchSize: zod_1.z.number().int().describe('Max files per ts-morph batch; larger projects skip dependency resolution (default 3000)').optional(),
     }).optional(),
     search: zod_1.z.object({
-        similarityThreshold: zod_1.z.number().optional(),
-        defaultLimit: zod_1.z.number().optional(),
-        maxLimit: zod_1.z.number().optional(),
-        autoTranslate: zod_1.z.boolean().optional(),
-        translateModel: zod_1.z.string().optional(),
+        similarityThreshold: zod_1.z.number().min(0).max(1).describe('Max cosine distance 0–1; lower = stricter (default 0.6)').optional(),
+        defaultLimit: zod_1.z.number().int().describe('Default result count (default 5)').optional(),
+        maxLimit: zod_1.z.number().int().describe('Hard cap on results (default 20)').optional(),
+        autoTranslate: zod_1.z.boolean().describe('Translate non-English queries before embedding').optional(),
+        translateModel: zod_1.z.string().describe('Ollama model for translation (default llama3.2)').optional(),
     }).optional(),
     reranker: zod_1.z.object({
-        enabled: zod_1.z.boolean().optional(),
-        model: zod_1.z.string().optional(),
-        url: zod_1.z.string().optional(),
-        overfetch: zod_1.z.number().int().min(1).max(20).optional(),
+        enabled: zod_1.z.boolean().describe('Enable cross-encoder reranking; requires reranker.model').optional(),
+        model: zod_1.z.string().describe('Reranker model name (e.g. qllama/bge-reranker-v2-m3)').optional(),
+        url: zod_1.z.string().describe('Full URL of the rerank endpoint (default ${ollama.host}/api/rerank)').optional(),
+        overfetch: zod_1.z.number().int().min(1).max(20).describe('Candidate multiplier before reranking (limit × N, default 3)').optional(),
     }).optional(),
     logging: zod_1.z.object({
-        level: zod_1.z.enum(['debug', 'info', 'warn', 'error']).optional(),
-        dir: zod_1.z.string().optional(),
+        level: zod_1.z.enum(['debug', 'info', 'warn', 'error']).describe('File log level (default error)').optional(),
+        dir: zod_1.z.string().describe('Base log directory; "false" to disable file logging').optional(),
     }).optional(),
-    workspaceRoot: zod_1.z.string().optional(),
+    workspaceRoot: zod_1.z.string().describe('Full path to the directory containing all your projects').optional(),
 });
 const FIELD_TYPES = {
     'db.host': 'string',
@@ -109,6 +118,34 @@ const FIELD_TYPES = {
     'workspaceRoot': 'string',
 };
 exports.ALL_KEYS = Object.keys(FIELD_TYPES);
+/**
+ * Single source of truth for built-in defaults, keyed by raw config.json dotted
+ * key. Consumed both by the web dashboard (`GET /api/defaults`) and by
+ * `resolvedSchema` in `src/config.ts`, whose `.default(...)` calls reference
+ * these values — so the runtime default and the dashboard-displayed default
+ * cannot diverge. `as const` keeps the literal types so those `.default()`
+ * lookups stay type-safe. Keys omitted here have no static default (required
+ * fields like db.host, or values derived at runtime like db.name → rag_<user>
+ * and reranker.url → ${ollama.host}/api/rerank).
+ */
+exports.CONFIG_DEFAULTS = {
+    'db.port': 5433,
+    'ollama.host': 'http://localhost:11434',
+    'ollama.model': constants_1.DEFAULT_EMBED_MODEL,
+    'indexing.chunkSize': 1500,
+    'indexing.chunkOverlap': 200,
+    'indexing.embedBatchSize': 5,
+    'indexing.astBatchSize': 3000,
+    'search.similarityThreshold': 0.6,
+    'search.defaultLimit': 5,
+    'search.maxLimit': 20,
+    'search.autoTranslate': false,
+    'search.translateModel': 'llama3.2',
+    'reranker.enabled': false,
+    'reranker.model': '',
+    'reranker.overfetch': 3,
+    'logging.level': 'error',
+};
 function readConfigJson() {
     if (!fs.existsSync(exports.CONFIG_FILE))
         return null;
@@ -127,17 +164,45 @@ function readConfigJson() {
         throw new Error(`Invalid JSON in ${exports.CONFIG_FILE}: ${e.message}\n` +
             `Fix the file manually or delete it and run: rag-setup`);
     }
-    const result = jsonSchema.safeParse(parsed);
+    return parseConfig(parsed, exports.CONFIG_FILE);
+}
+/**
+ * Validate a parsed config object against the Zod schema. Unknown keys (e.g.
+ * the "$schema" editor reference) are stripped. Throws with a caller-friendly
+ * message on validation failure. Pure — no file I/O.
+ */
+function parseConfig(raw, source = exports.CONFIG_FILE) {
+    const result = jsonSchema.safeParse(raw);
     if (!result.success) {
         const issues = result.error.issues.map(i => `  ${i.path.join('.')}: ${i.message}`).join('\n');
-        throw new Error(`Invalid config in ${exports.CONFIG_FILE}:\n${issues}\n` +
+        throw new Error(`Invalid config in ${source}:\n${issues}\n` +
             `Fix with: rag-config set <key> <value>`);
     }
     return result.data;
 }
+/** Build the JSON Schema object generated from the Zod config schema. Pure. */
+function buildJsonSchema() {
+    return {
+        $id: 'https://github.com/oleksandr-antoniuk/RAG/config.schema.json',
+        title: 'codesearch-mcp config',
+        ...zod_1.z.toJSONSchema(jsonSchema),
+    };
+}
 function writeConfigJson(data) {
     fs.mkdirSync(exports.CONFIG_DIR, { recursive: true });
-    fs.writeFileSync(exports.CONFIG_FILE, JSON.stringify(data, null, 2) + '\n', { mode: 0o600 });
+    writeSchemaFile();
+    // $schema first so editors pick it up; readConfigJson strips it on validation.
+    const withSchema = { $schema: SCHEMA_REF, ...data };
+    fs.writeFileSync(exports.CONFIG_FILE, JSON.stringify(withSchema, null, 2) + '\n', { mode: 0o600 });
+}
+/**
+ * Generate a JSON Schema from the Zod config schema and write it next to
+ * config.json. Editors resolve it via the "$schema" reference and provide
+ * key autocomplete, type hints, and inline validation while editing.
+ */
+function writeSchemaFile() {
+    fs.mkdirSync(exports.CONFIG_DIR, { recursive: true });
+    fs.writeFileSync(exports.SCHEMA_FILE, JSON.stringify(buildJsonSchema(), null, 2) + '\n');
 }
 function getNestedValue(cfg, key) {
     const parts = key.split('.');

package/dist/src/config.js

@@ -37,7 +37,6 @@ exports.Config = exports.ConfigError = void 0;
 const os = __importStar(require("os"));
 const zod_1 = require("zod");
 const config_store_1 = require("./config-store");
-const constants_1 = require("./constants");
 class ConfigError extends Error {
     constructor(message) {
         super(message);
@@ -48,34 +47,34 @@ exports.ConfigError = ConfigError;
 const resolvedSchema = zod_1.z.object({
     db: zod_1.z.object({
         host: zod_1.z.string().min(1, 'required — run rag-setup'),
-        port: zod_1.z.number().int().positive().default(5433),
+        port: zod_1.z.number().int().positive().default(config_store_1.CONFIG_DEFAULTS['db.port']),
         username: zod_1.z.string().min(1, 'required — run rag-setup'),
         password: zod_1.z.string().min(1, 'required — run rag-setup'),
         database: zod_1.z.string().min(1),
     }),
     ollama: zod_1.z.object({
-        host: zod_1.z.string().min(1).default('http://localhost:11434'),
-        model: zod_1.z.string().min(1).default(constants_1.DEFAULT_EMBED_MODEL),
-        rerankerModel: zod_1.z.string().default(''),
+        host: zod_1.z.string().min(1).default(config_store_1.CONFIG_DEFAULTS['ollama.host']),
+        model: zod_1.z.string().min(1).default(config_store_1.CONFIG_DEFAULTS['ollama.model']),
+        rerankerModel: zod_1.z.string().default(config_store_1.CONFIG_DEFAULTS['reranker.model']),
         rerankerUrl: zod_1.z.string().min(1),
     }),
     indexer: zod_1.z.object({
-        chunkSize: zod_1.z.number().int().positive().default(1500),
-        chunkOverlap: zod_1.z.number().int().min(0).default(200),
-        batchSize: zod_1.z.number().int().positive().default(5),
-        astBatchSize: zod_1.z.number().int().positive().default(3000),
+        chunkSize: zod_1.z.number().int().positive().default(config_store_1.CONFIG_DEFAULTS['indexing.chunkSize']),
+        chunkOverlap: zod_1.z.number().int().min(0).default(config_store_1.CONFIG_DEFAULTS['indexing.chunkOverlap']),
+        batchSize: zod_1.z.number().int().positive().default(config_store_1.CONFIG_DEFAULTS['indexing.embedBatchSize']),
+        astBatchSize: zod_1.z.number().int().positive().default(config_store_1.CONFIG_DEFAULTS['indexing.astBatchSize']),
     }),
     search: zod_1.z.object({
-        similarityThreshold: zod_1.z.number().min(0).max(1).default(0.6),
-        defaultLimit: zod_1.z.number().int().positive().default(5),
-        maxLimit: zod_1.z.number().int().positive().default(20),
-        autoTranslate: zod_1.z.boolean().default(false),
-        translateModel: zod_1.z.string().default('llama3.2'),
-        rerankerEnabled: zod_1.z.boolean().default(false),
-        rerankerOverfetch: zod_1.z.number().int().min(1).max(20).default(3),
+        similarityThreshold: zod_1.z.number().min(0).max(1).default(config_store_1.CONFIG_DEFAULTS['search.similarityThreshold']),
+        defaultLimit: zod_1.z.number().int().positive().default(config_store_1.CONFIG_DEFAULTS['search.defaultLimit']),
+        maxLimit: zod_1.z.number().int().positive().default(config_store_1.CONFIG_DEFAULTS['search.maxLimit']),
+        autoTranslate: zod_1.z.boolean().default(config_store_1.CONFIG_DEFAULTS['search.autoTranslate']),
+        translateModel: zod_1.z.string().default(config_store_1.CONFIG_DEFAULTS['search.translateModel']),
+        rerankerEnabled: zod_1.z.boolean().default(config_store_1.CONFIG_DEFAULTS['reranker.enabled']),
+        rerankerOverfetch: zod_1.z.number().int().min(1).max(20).default(config_store_1.CONFIG_DEFAULTS['reranker.overfetch']),
     }),
     logging: zod_1.z.object({
-        level: zod_1.z.enum(['debug', 'info', 'warn', 'error']).default('error'),
+        level: zod_1.z.enum(['debug', 'info', 'warn', 'error']).default(config_store_1.CONFIG_DEFAULTS['logging.level']),
         dir: zod_1.z.string().optional(),
     }),
     workspaceRoot: zod_1.z.string().default(''),

package/dist/src/constants.d.ts

@@ -1 +1,2 @@
-export declare const DEFAULT_EMBED_MODEL = "bge-m3";
+export declare const SUPPORTED_EMBED_MODELS: readonly ["bge-m3"];
+export declare const DEFAULT_EMBED_MODEL: string;

package/dist/src/constants.js

@@ -1,7 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_EMBED_MODEL = void 0;
+exports.DEFAULT_EMBED_MODEL = exports.SUPPORTED_EMBED_MODELS = void 0;
 // Embedding model is tied to the vector column dimension (bge-m3 → 1024).
-// Change both together: update this constant, drop/recreate the `embedding` column,
-// and re-run indexing.
-exports.DEFAULT_EMBED_MODEL = 'bge-m3';
+// Only 1024-dim models belong here — switching requires dropping/recreating the
+// `embedding` column and re-indexing. The dashboard offers this list as a strict
+// dropdown for ollama.model (no free text) so a mismatched model can't be set.
+exports.SUPPORTED_EMBED_MODELS = ['bge-m3'];
+exports.DEFAULT_EMBED_MODEL = exports.SUPPORTED_EMBED_MODELS[0];

package/dist/src/container.d.ts

@@ -1,15 +1,19 @@
 import { Config } from './config';
-import { DatabaseService } from './services/DatabaseService';
 import { IndexerService } from './services/IndexerService';
-import { SearcherService } from './services/SearcherService';
 import { McpServer } from './services/McpServer';
-import { LoggerService } from './services/LoggerService';
+import type { IDatabase } from './interfaces';
+import type { IEmbedder } from './interfaces';
+import type { ISearcher } from './interfaces';
+import type { ILogger } from './interfaces';
+import type { IProjectDiscovery } from './interfaces';
 export interface Container {
     config: Config;
-    db: DatabaseService;
+    db: IDatabase;
+    embedder: IEmbedder;
     indexer: IndexerService;
-    searcher: SearcherService;
+    searcher: ISearcher;
     mcp: McpServer;
-    logger: LoggerService;
+    logger: ILogger;
+    discovery: IProjectDiscovery;
 }
 export declare function createContainer(loggerName?: string): Container;

package/dist/src/container.js

@@ -9,14 +9,17 @@ const IndexerService_1 = require("./services/IndexerService");
 const SearcherService_1 = require("./services/SearcherService");
 const McpServer_1 = require("./services/McpServer");
 const LoggerService_1 = require("./services/LoggerService");
+const MonorepoAwareDiscoveryService_1 = require("./services/MonorepoAwareDiscoveryService");
+const NxMonorepoResolver_1 = require("./services/NxMonorepoResolver");
 function createContainer(loggerName) {
     const config = new config_1.Config();
     const logger = LoggerService_1.LoggerService.fromConfig(config.logging, loggerName);
     const db = new DatabaseService_1.DatabaseService(config);
-    const embedder = new OllamaEmbedder_1.OllamaEmbedder(config);
+    const embedder = new OllamaEmbedder_1.OllamaEmbedder(config, logger);
     const ast = new AstParserService_1.AstParserService(logger);
+    const discovery = new MonorepoAwareDiscoveryService_1.MonorepoAwareDiscoveryService([new NxMonorepoResolver_1.NxMonorepoResolver(logger)], logger);
     const indexer = new IndexerService_1.IndexerService(db, embedder, ast, config, logger);
-    const searcher = new SearcherService_1.SearcherService(db, embedder, config, logger);
+    const searcher = new SearcherService_1.SearcherService(db, embedder, discovery, config, logger);
     const mcp = new McpServer_1.McpServer(searcher, config, logger);
-    return { config, db, indexer, searcher, mcp, logger };
+    return { config, db, embedder, indexer, searcher, mcp, logger, discovery };
 }

package/dist/src/graph.d.ts

@@ -1,4 +1,64 @@
+import { type ProjectMeta } from './file-utils';
+type ProjectNode = {
+    name: string;
+    nxRepo?: boolean;
+} & ProjectMeta;
+type Edge = {
+    from: string;
+    to: string;
+    label: string;
+};
+export interface GraphData {
+    nodes: ProjectNode[];
+    edges: Edge[];
+}
+/** A single named graph tab (Workspace, or one per nested Nx repo). */
+export interface GraphView {
+    name: string;
+    nodes: ProjectNode[];
+    edges: Edge[];
+}
+/**
+ * Build the project graph data (nodes + relation edges) from a project list.
+ * Pure apart from reading each project's `.ragmeta.json`. Shared by the console
+ * graph, the graph views, and the web dashboard's `/api/graph`.
+ */
+export declare function buildGraphData(projects: {
+    name: string;
+    path: string;
+}[]): GraphData;
+/**
+ * Split a project list into graph tabs. A project whose name contains a `/`
+ * belongs to a nested Nx repo (`<repo>/<sub-project>`); everything else is a
+ * flat top-level project.
+ *
+ * - **Workspace** tab: flat projects + one node per Nx repo (collapsed to a
+ *   single `nxRepo` node); edges from `.ragmeta.json` relations.
+ * - **One tab per Nx repo**: its sub-projects as nodes, with edges between them
+ *   taken from real import dependencies (`projectEdges`, from `code_dependency`).
+ *
+ * Returns the Workspace view first, then repo views sorted by name.
+ */
+export declare function buildGraphViews(projects: {
+    name: string;
+    path: string;
+}[], projectEdges: {
+    from: string;
+    to: string;
+}[], workspaceRoot: string): GraphView[];
+/**
+ * Render the full interactive graph page (vis-network + inner tabs, edge-type
+ * filters, legend, project toggle list). Used for the standalone
+ * `project-graph.html` and served by the web dashboard at `GET /graph` (embedded
+ * via iframe) so both share one implementation. Tab 0 is the Workspace view;
+ * double-clicking an Nx-repo node opens that repo's tab.
+ */
+export declare function buildHtml(views: GraphView[]): string;
 export declare function generateProjectGraph(projects: {
     name: string;
     path: string;
+}[], projectEdges: {
+    from: string;
+    to: string;
 }[], workspacePath: string): void;
+export {};