xindex 1.0.15 → 1.0.17

package/.xindex.json

@@ -100,7 +100,8 @@
     "*.otf",
     ".gitkeep",
     "package-lock.json",
-    "yarn.lock"
+    "yarn.lock",
+    "*.mp4"
   ],
   "maxLines": 30,
   "maxFileBytes": 100000,

package/README.md

@@ -104,12 +104,12 @@ name: ask-xi
 description: Discovers relevant files via xindex semantic search — preps queries, auto-indexes on empty, returns file links with keywords. Triggered by @xi.
 argument-hint: "[question]"
 ---
-Surface-level codebase discovery via xindex. Tool: `xindex_search` (natural-language, meaning-based).
+Surface-level codebase discovery via xindex. Tool: `xindex_search` (natural-language, meaning-based). Must trigger search when a session starts, a new task starts, or any codebase lookup is needed.
 
 **Steps:**
-1. Draft 3–7 queries from $ARGUMENTS (entry points, routing, config, tests, patterns); run `xindex_search` in parallel.
+1. Draft 3–5 queries from $ARGUMENTS (entry points, routing, config, tests, patterns); run `xindex_search` in parallel.
 2. If empty/sparse/stale → scoped `xindex_index` on relevant root folders (one path per call, e.g. `src`, `skills`, `agents`), then re-search. Prefer scoped over full-repo.
-3. Run 3–7 narrower follow-ups in parallel based on round-1 hits.
+3. Think, then run 3+ narrower follow-ups in parallel based on round-1 hits.
 4. Return file paths + brief keywords showing why each matched.
 
 Output = file links + keywords, not analysis. **Escalate to `/ask-cursor` by default** (cheap codebase reasoning); only go to `/ask-claude` for multi-file/pattern analysis or `/ask-claude-opus` for trade-offs. For reset or full re-index, delegate to `/xindex` (owns safety rules).

package/apps/mcpApp.ts

@@ -34,16 +34,19 @@ export function McpApp({
     config: IXindexConfig,
 }): IMcpApp {
     return async function mcpApp() {
-        const server = new McpServer({name: "xindex", version: "0.1.0"});
+        const server = new McpServer({name: "xindex", version: "1.0.0"}, {
+            instructions: "@xi must trigger search when a session starts, a new task starts, or any codebase lookup is needed. Run `xindex_search`: 3–5 parallel queries, then think, then 3+ narrowed follow-ups. If results are sparse, run scoped `xindex_index` (one path per call) and re-search.",
+        });
 
         // --- search ---
 
         server.registerTool("xindex_search", {
             title: "Search codebase (semantic)",
-            description: "Semantic codebase search — finds files by meaning, not substring. " +
-                "For discovery, run 3–7 parallel queries then narrower follow-ups. " +
-                "Returns ranked file paths + matched keywords (links, not analysis). " +
-                "If sparse, run `xindex_index` on relevant roots first (scoped, one path per call).",
+            description: "Semantic codebase discovery by meaning. " +
+                "Must trigger when a session starts, a new task starts, or any codebase lookup is needed. " +
+                "Start with 3–5 parallel queries, then 3+ narrowed follow-ups. " +
+                "Return ranked file paths + keywords (links, not analysis). " +
+                "If sparse, run scoped `xindex_index` first (one path per call).",
             inputSchema: z.object({
                 query: z.string()
                     .describe("Natural language search query"),
@@ -68,9 +71,9 @@ export function McpApp({
 
         server.registerTool("xindex_index", {
             title: "Index files or directories",
-            description: "Index files/directories for semantic search; recursive, respects .gitignore. " +
-                "Prefer scoped paths (one per call, e.g. `src`, `apps`) over full-repo `['.']` — " +
-                "reserve the latter for first-time setup or cross-cutting discovery.",
+            description: "Index paths recursively; respects .gitignore. " +
+                "Prefer scoped (`src`, `apps`) over `['.']` (reserve for first-time/cross-cutting). " +
+                "Stale results → `xindex_reset` → `xindex_index`.",
             inputSchema: z.object({
                 inputs: z.array(z.string()).min(1)
                     .describe("File or directory paths to index (one path per call preferred; scoped over full-repo)"),
@@ -94,8 +97,8 @@ export function McpApp({
 
         server.registerTool("xindex_reset", {
             title: "Reset index (destructive)",
-            description: "Wipe and recreate the semantic index. **Destructive** — MUST get explicit user confirmation; " +
-                "if ambiguous, don't run. Recovery / reindex flow: confirm → `xindex_reset` → `xindex_index(['.'])` → `xindex_search`.",
+            description: "Wipe the semantic index. **Destructive** — require explicit confirmation; " +
+                "if ambiguous, don't run. After: `xindex_index(['.'])`.",
             inputSchema: z.object({}),
             annotations: {destructiveHint: true},
         }, async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xindex",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "description": "Local semantic code search — index codebase, search by meaning or keywords",
   "type": "module",
   "main": "xindex.ts",
@@ -22,7 +22,8 @@
     "watch": "tsx apps/run.watch.ts",
     "test.functional": "bash test/functional.sh",
     "test.compilation": "npx -y tsc --ignoreConfig --noEmit --target ES2022 --module ESNext --moduleResolution bundler --esModuleInterop --skipLibCheck --strict false $(git ls-files '*.ts')",
-    "test.npx": "docker run --rm -it -w /tmp node:22 bash -c 'npm i -g xindex && xindex-index tsx-0 && xindex-search streamx map | grep \"await mapper\" && which xindex | grep bin/xindex' "
+    "test.npx": "docker run --rm -it -w /tmp node:22 bash -c 'npm i -g xindex && xindex-index tsx-0 && xindex-search streamx map | grep \"await mapper\" && which xindex | grep bin/xindex' ",
+    "console": "docker run --rm -it -v \"$PWD:/app\" -w /app node:22 bash"
   },
   "private": false,
   "engines": {