xindex 1.0.14 → 1.0.16

package/.xindex.json

@@ -87,7 +87,21 @@
   ],
   "ignoreFiles": [
     ".xindex",
-    "media"
+    "*.png",
+    "*.jpg",
+    "*.jpeg",
+    "*.gif",
+    "*.svg",
+    "*.ico",
+    "*.woff",
+    "*.woff2",
+    "*.ttf",
+    "*.eot",
+    "*.otf",
+    ".gitkeep",
+    "package-lock.json",
+    "yarn.lock",
+    "*.mp4"
   ],
   "maxLines": 30,
   "maxFileBytes": 100000,

package/CLAUDE.md

@@ -28,7 +28,7 @@
 - **Section splitting**: large `.md` files → `*.1.*`, `*.2.*` parts. Original becomes index with bullet summaries.
 - **Detail expansion**: reread task → research every step (files, APIs, deps) → expand with concrete details (paths, functions, tables, exact changes) → preserve NxM shape → no info loss → update diagram → keep balanced detail density
 - **Context recovery**: when chat compacts, reread active task's log to recover direction
-- **Completed tasks**: move done tasks (+ their logs, maps, reports) to `.ai/task/done/`. Update `done/INDEX.md` (relative links, newest-first). Root `INDEX.md` lists only active/pending tasks + a link to `done/INDEX.md`.
+- **Completed tasks**: move done tasks (+ their logs, maps, reports) to `.ai/task/done/`. Use xindex search for discovery instead of manual index documents.
 
 ## Code Patterns
 

package/README.md

@@ -107,9 +107,9 @@ argument-hint: "[question]"
 Surface-level codebase discovery via xindex. Tool: `xindex_search` (natural-language, meaning-based).
 
 **Steps:**
-1. Draft 3–7 queries from $ARGUMENTS (entry points, routing, config, tests, patterns); run `xindex_search` in parallel.
+1. Draft 1–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 2+ 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 triggers this. Run `xindex_search` at session/task start. 1–5 parallel queries → think → 2+ follow-ups; empty → `xindex_index` scoped root.",
+        });
 
         // --- 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 search by meaning. " +
+                "@xi triggers this; run at session/task start. " +
+                "1–5 parallel queries → think → 2+ narrower follow-ups. " +
+                "Returns ranked file paths + keywords (links, not analysis). " +
+                "If sparse, `xindex_index` scoped root 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/components/walkFiles.ts

@@ -20,6 +20,12 @@ export function WalkFiles({cwd, log, ignoreFiles = [], followSymlinks = false}:
         }
     }
 
+    const HARD_SKIP = new Set([".git", ".xindex"]);
+
+    function isHardlySkipped(name: string): boolean {
+        return HARD_SKIP.has(name);
+    }
+
     const visited = new Set<string>();
 
     async function* walk(dir: string, parentRules: string[]): AsyncIterable<string> {
@@ -45,7 +51,7 @@ export function WalkFiles({cwd, log, ignoreFiles = [], followSymlinks = false}:
                     visited.add(real);
                     const s = await stat(real);
                     if (s.isDirectory()) {
-                        if (entry.name.startsWith(".")) continue;
+                        if (isHardlySkipped(entry.name)) continue;
                         if (ig.ignores(rel + "/")) continue;
                         yield* walk(abs, rules);
                     } else if (s.isFile()) {
@@ -59,7 +65,7 @@ export function WalkFiles({cwd, log, ignoreFiles = [], followSymlinks = false}:
             }
 
             if (entry.isDirectory()) {
-                if (entry.name.startsWith(".")) continue;
+                if (isHardlySkipped(entry.name)) continue;
                 if (ig.ignores(rel + "/")) continue;
                 yield* walk(abs, rules);
             } else if (entry.isFile()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xindex",
-  "version": "1.0.14",
+  "version": "1.0.16",
   "description": "Local semantic code search — index codebase, search by meaning or keywords",
   "type": "module",
   "main": "xindex.ts",
@@ -17,10 +17,13 @@
     "search": "tsx apps/run.search.ts",
     "reset": "tsx apps/run.reset.ts",
     "test": "npm run test.functional && npm run test.compilation",
+    "dev.ci": "npm run test && npm run test.npx",
     "mcp": "tsx apps/run.mcp.ts",
     "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.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' ",
+    "console": "docker run --rm -it -v \"$PWD:/app\" -w /app node:22 bash"
   },
   "private": false,
   "engines": {