xindex 1.0.26 → 1.0.27

package/README.md

@@ -157,7 +157,7 @@ xindex-index apps features
 
 ### `xindex-search <query...>`
 
-Search the index. Args are joined into one query. Default limit: 7.
+Search the index. Args are joined into one query. Default limit: 7 (capped by `searchMaxLimit`, default 12).
 
 ```bash
 xindex-search "database migration logic"
@@ -197,7 +197,7 @@ MCP stdio server; background watcher by default. Flags: `--watch-disabled`, `--w
 
 ## MCP tools
 
-- **`xindex_search`** — semantic search. `query: string`, `limit?: number` (default 7, max 50).
+- **`xindex_search`** — semantic search. `query: string`, `limit?: number` (default 7, capped at `searchMaxLimit` from `.xindex.json`, default 12).
 - **`xindex_index`** — index paths. `inputs: string[]` (at least one).
 - **`xindex_reset`** — wipe index (destructive). No input.
 
@@ -210,6 +210,8 @@ Project-root file. All fields optional; unknown keys ignored; missing/empty →
 - **`ignoreKeywords`** — `string[]`, default `[]`. Tokens stripped before embedding — add project slang/boilerplate polluting results. Entries ≤1 char warn.
 - **`ignoreFiles`** — `string[]`, default `['.xindex', 'node_modules']`. Extra globs excluded during walk/watch, on top of `.gitignore`. Setting this **replaces** the default — re-include `.xindex` and `node_modules` if you still want them skipped.
 - **`maxLines`** — `number`, default `30`. Lines per chunk — tune if chunks feel over/under-sized.
+- **`searchDefaultLimit`** — `number`, default `7`. Results per search when no `limit` is passed.
+- **`searchMaxLimit`** — `number`, default `12`. Hard cap on `limit` (MCP and CLI); values above this are clamped. `searchDefaultLimit` cannot exceed this.
 - **`maxFileBytes`** — `number`, default `50000`. Skip files over this (50 KB) — raise to index larger generated files.
 - **`followSymlinks`** — `boolean`, default `false`. When `false`, symlinks are skipped with a log line. `true` follows them (cycles broken via `realpath` dedup).
 
@@ -220,6 +222,8 @@ Full example with every option (copy-paste and trim what you don't need):
   "ignoreKeywords": ["import", "export", "function", "const"],
   "ignoreFiles": [".xindex", "node_modules", "dist/**"],
   "maxLines": 30,
+  "searchDefaultLimit": 7,
+  "searchMaxLimit": 12,
   "maxFileBytes": 50000,
   "followSymlinks": false
 }

package/apps/mcpApp.ts

@@ -50,8 +50,9 @@ export function McpApp({
             inputSchema: z.object({
                 query: z.string()
                     .describe("Natural language search query"),
-                limit: z.number().int().min(1).max(50).default(config.searchDefaultLimit)
-                    .describe(`Max results to return default ${config.searchDefaultLimit}, max 50)`),
+                limit: z.number().int().min(1).default(config.searchDefaultLimit)
+                    .transform(v => Math.min(v, config.searchMaxLimit))
+                    .describe(`Max results (default ${config.searchDefaultLimit}, capped at ${config.searchMaxLimit})`),
                 windowLines: z.number().int().min(1).default(config.maxLines).optional()
                     .describe("Optional line-window size for per-file snippet locating"),
                 includePaths: z.array(z.string()).optional()

package/apps/run.mcp.ts

@@ -29,7 +29,11 @@ const indexApp = async (inputs: string[]) => {
     await rawIndexApp(inputs);
     await flush();
 };
-const search = SearchApp({searchIndex: searchContentIndex, searchDefaultLimit: config.searchDefaultLimit});
+const search = SearchApp({
+    searchIndex: searchContentIndex,
+    searchDefaultLimit: config.searchDefaultLimit,
+    searchMaxLimit: config.searchMaxLimit,
+});
 
 const appId = AppId();
 const watcherLock = WatcherLock({

package/apps/run.search.ts

@@ -5,7 +5,11 @@ import {FormatSearchResults} from "../components/index/formatSearchResults.js";
 
 const log = BufferedLoggerToStdOut();
 const {searchContentIndex, config} = await BuildComponents({log});
-const search = SearchApp({searchIndex: searchContentIndex, searchDefaultLimit: config.searchDefaultLimit});
+const search = SearchApp({
+    searchIndex: searchContentIndex,
+    searchDefaultLimit: config.searchDefaultLimit,
+    searchMaxLimit: config.searchMaxLimit,
+});
 
 const query = process.argv.slice(2).join(" ");
 if (!query) {

package/apps/searchApp.ts

@@ -1,14 +1,20 @@
+import {clampSearchLimit, SEARCH_DEFAULT_LIMIT} from "../components/config/searchLimits.js";
 import {IIndexRecord, ISearchIndex, ISearchIndexOptions} from "../features/searchIndex.js";
 
 export type ISearchApp = (query: string, options?: Partial<ISearchIndexOptions>) => Promise<IIndexRecord[]>;
 
-export function SearchApp({searchIndex, searchDefaultLimit = 7}: {
+export function SearchApp({
+    searchIndex,
+    searchDefaultLimit = SEARCH_DEFAULT_LIMIT,
+    searchMaxLimit,
+}: {
     searchIndex: ISearchIndex;
     searchDefaultLimit?: number;
+    searchMaxLimit: number;
 }): ISearchApp {
     return async function search(query, options = {}) {
         const normalizedOptions: ISearchIndexOptions = {
-            limit: options.limit ?? searchDefaultLimit,
+            limit: clampSearchLimit(options.limit ?? searchDefaultLimit, searchMaxLimit),
             prefetchMultiplier: options.prefetchMultiplier,
             scoreThreshold: options.scoreThreshold,
             locateInFiles: options.locateInFiles,

package/components/config/loadConfig.ts

@@ -1,9 +1,9 @@
 import {readFile} from "fs/promises";
+import {clampSearchLimit, SEARCH_DEFAULT_LIMIT, SEARCH_MAX_LIMIT} from "./searchLimits.js";
 import {IXindexConfig} from "./xindexConfig.js";
 import {ILogger} from "../logger.js";
 
 const DEFAULT_MAX_LINES = 30;
-const DEFAULT_SEARCH_DEFAULT_LIMIT = 7;
 const DEFAULT_SEARCH_CONCURRENCY = 4;
 const DEFAULT_MAX_FILE_BYTES = 50_000;
 const DEFAULT_FOLLOW_SYMLINKS = false;
@@ -13,7 +13,8 @@ const DEFAULTS: IXindexConfig = {
     ignoreKeywords: [],
     ignoreFiles: DEFAULT_IGNORE_FILES,
     maxLines: DEFAULT_MAX_LINES,
-    searchDefaultLimit: DEFAULT_SEARCH_DEFAULT_LIMIT,
+    searchDefaultLimit: SEARCH_DEFAULT_LIMIT,
+    searchMaxLimit: SEARCH_MAX_LIMIT,
     searchConcurrency: DEFAULT_SEARCH_CONCURRENCY,
     maxFileBytes: DEFAULT_MAX_FILE_BYTES,
     followSymlinks: DEFAULT_FOLLOW_SYMLINKS,
@@ -45,11 +46,13 @@ export function LoadConfig({configPath, log}: { configPath: string, log: ILogger
         const toStrings = (v: unknown) => Array.isArray(v) ? v.filter((e): e is string => typeof e === "string") : [];
         const toNum = (v: unknown, def: number): number => typeof v === "number" ? v : def;
 
+        const searchMaxLimit = clampSearchLimit(toNum(parsed.searchMaxLimit, SEARCH_MAX_LIMIT));
         const config: IXindexConfig = {
             ignoreKeywords: toStrings(parsed.ignoreKeywords),
             ignoreFiles: toStrings(parsed.ignoreFiles),
             maxLines: toNum(parsed.maxLines, DEFAULT_MAX_LINES),
-            searchDefaultLimit: Math.max(1, toNum(parsed.searchDefaultLimit, DEFAULT_SEARCH_DEFAULT_LIMIT)),
+            searchMaxLimit,
+            searchDefaultLimit: clampSearchLimit(toNum(parsed.searchDefaultLimit, SEARCH_DEFAULT_LIMIT), searchMaxLimit),
             searchConcurrency: Math.max(1, toNum(parsed.searchConcurrency, DEFAULT_SEARCH_CONCURRENCY)),
             maxFileBytes: toNum(parsed.maxFileBytes, DEFAULT_MAX_FILE_BYTES),
             followSymlinks: typeof parsed.followSymlinks === "boolean" ? parsed.followSymlinks : DEFAULT_FOLLOW_SYMLINKS,

package/components/config/searchLimits.ts

@@ -0,0 +1,6 @@
+export const SEARCH_DEFAULT_LIMIT = 7;
+export const SEARCH_MAX_LIMIT = 12;
+
+export function clampSearchLimit(limit: number, max = SEARCH_MAX_LIMIT): number {
+    return Math.min(max, Math.max(1, limit));
+}

package/components/config/xindexConfig.ts

@@ -3,6 +3,7 @@ export type IXindexConfig = {
     ignoreFiles: string[];
     maxLines: number;
     searchDefaultLimit: number;
+    searchMaxLimit: number;
     searchConcurrency: number;
     maxFileBytes: number;
     followSymlinks: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xindex",
-  "version": "1.0.26",
+  "version": "1.0.27",
   "description": "Local semantic code search — index codebase, search by meaning or keywords",
   "type": "module",
   "main": "xindex.ts",