feat: Add global search across all indexed projects (v1.11.0)

5 new tools: global_init, global_status, global_query, global_signatures,
global_refresh. Uses SQLite ATTACH DATABASE for zero-copy cross-project
queries with 5-min session cache. Bulk indexing with browser-based SSE
progress UI (port 3334). Extended excludes for embedded Python runtimes,
fdk-aac, and other external code.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: CSCSoftware

.claude/CLAUDE.md

@@ -2,7 +2,7 @@
 
 MCP Server für persistentes Code-Indexing. Ermöglicht Claude Code schnelle, präzise Suchen statt Grep/Glob.
 
-**Version:** 1.9.0 | **Sprachen:** 11 | **Repo:** https://github.com/CSCSoftware/AiDex
+**Version:** 1.11.0 | **Sprachen:** 11 | **Repo:** https://github.com/CSCSoftware/AiDex
 
 ## Build & Run
 
@@ -36,7 +36,7 @@ Registriert als MCP Server `aidex` (Prefix: `mcp__aidex__aidex_*`).
 **Nach Änderungen:** Build ausführen, dann Claude Code neu starten.
 **MCP-Name:** Server muss als `"aidex"` registriert sein → Prefix wird `mcp__aidex__aidex_*`.
 
-## Tools (22)
+## Tools (27)
 
 ### Suche & Index
 | Tool | Beschreibung |
@@ -88,6 +88,15 @@ Status: `backlog → active → done | cancelled`
 | `aidex_screenshot` | Screenshot aufnehmen (fullscreen/active_window/window/region) |
 | `aidex_windows` | Offene Fenster auflisten (Helper für window-Modus) |
 
+### Global Search (v1.11+)
+| Tool | Beschreibung |
+|------|--------------|
+| `aidex_global_init` | Verzeichnisbaum scannen, Projekte in `~/.aidex/global.db` registrieren. `index_unindexed`: Auto-Index ≤500 Dateien. `show_progress`: Browser Progress-UI |
+| `aidex_global_status` | Alle registrierten Projekte mit Stats anzeigen |
+| `aidex_global_query` | Terme über ALLE Projekte suchen (ATTACH DATABASE, 5-Min Cache) |
+| `aidex_global_signatures` | Methoden/Typen nach Name über alle Projekte suchen |
+| `aidex_global_refresh` | Stats aktualisieren, veraltete Projekte entfernen |
+
 ## Sprachen
 
 C# · TypeScript · JavaScript · Rust · Python · C · C++ · Java · Go · PHP · Ruby
@@ -105,11 +114,20 @@ src/
 │   ├── summary.ts, link.ts, scan.ts, files.ts
 │   ├── session.ts, note.ts, task.ts
 │   ├── screenshot/              # Plattform-Screenshots
-│   └── viewer/server.ts
+│   └── global/                  # Global Search (v1.11)
+│       ├── global-init.ts       # Scan + Bulk-Index
+│       ├── global-query.ts      # ATTACH DATABASE Queries
+│       ├── global-signatures.ts # Methoden/Typen suchen
+│       ├── global-status.ts     # Projekt-Übersicht
+│       └── global-refresh.ts    # Stats aktualisieren
+├── viewer/
+│   ├── server.ts         # Interactive Viewer (Port 3333)
+│   └── progress.ts       # SSE Progress UI (Port 3334)
 ├── db/
 │   ├── database.ts       # SQLite (WAL)
 │   ├── queries.ts        # Prepared Statements
-│   └── schema.sql
+│   ├── schema.sql        # Projekt-DB Schema
+│   └── global-database.ts # ~/.aidex/global.db
 └── parser/
     ├── tree-sitter.ts    # Parser (1MB Buffer)
     ├── extractor.ts      # Identifier + Signaturen
@@ -190,6 +208,21 @@ aidex_windows({ filter: "chrome" })                            # Fenster finden
 - Optional: `filename` und `save_path` für andere Pfade
 - Rückgabe: Dateipfad → Claude kann sofort `Read` aufrufen
 
+### Global Search (v1.11)
+```
+aidex_global_init({ path: "Q:/develop" })                              # Nur registrieren
+aidex_global_init({ path: "Q:/develop", index_unindexed: true, show_progress: true })  # Alles indexieren + Progress-UI
+aidex_global_query({ term: "TransparentWindow", mode: "contains" })    # Über alle Projekte suchen
+aidex_global_signatures({ term: "Render", kind: "method" })            # Methoden über alle Projekte
+aidex_global_status({ sort: "recent" })                                # Projektliste
+aidex_global_refresh()                                                 # Stats updaten
+```
+- `~/.aidex/global.db` referenziert alle Projekt-DBs
+- SQLite ATTACH DATABASE — kein Daten-Kopieren
+- Session-Cache (5-Min TTL) für schnelle wiederholte Queries
+- Bulk-Index: ≤500 Code-Dateien automatisch, >500 werden dem User gezeigt
+- Progress-UI: SSE-basiert auf Port 3334 mit Browser-Auto-Open
+
 ### Auto-Cleanup (v1.3.1)
 `aidex_init` entfernt automatisch Dateien die jetzt excluded sind (z.B. build/).
 Zeigt "Files removed: N" im Ergebnis.

CHANGELOG.md

@@ -2,6 +2,58 @@
 
 All notable changes to AiDex will be documented in this file.
 
+## [1.11.0] - 2026-03-07
+
+### Added
+- **Global Search**: Search across ALL indexed projects at once — 5 new tools
+  - `aidex_global_init` — Scan directory tree, register indexed projects in `~/.aidex/global.db`, detect unindexed projects by project markers (`.csproj`, `package.json`, `Cargo.toml`, etc.)
+  - `aidex_global_status` — List all registered projects with stats, sortable by name/size/recent
+  - `aidex_global_query` — Cross-project term search (exact/contains/starts_with) with in-memory session caching (5-min TTL)
+  - `aidex_global_signatures` — Search methods/types by name across all projects, filterable by kind
+  - `aidex_global_refresh` — Update stats and remove stale projects
+  - Uses SQLite `ATTACH DATABASE` for zero-copy queries — each project DB remains the single source of truth
+  - `exclude` parameter on `global_init` to skip external repos (e.g., `["llama.cpp"]`)
+  - Auto-updates global registry after `aidex_init` / `aidex_update`
+- **Bulk Indexing**: `global_init` can auto-index all unindexed projects in one call
+  - `index_unindexed: true` — Auto-index projects with ≤500 code files
+  - Large projects (>500 files) are listed separately for user decision
+  - File count estimation uses code-only extensions (matches what `init()` actually processes)
+- **Progress UI**: Browser-based progress display for bulk indexing
+  - `show_progress: true` — Opens `http://localhost:3334` with live progress bar
+  - Server-Sent Events (SSE) for real-time updates
+  - Shows per-project status (indexing/done/error), progress bar, scrolling log
+  - Dark theme, auto-closes after completion
+- **Extended excludes**: Better handling of embedded runtimes and external code
+  - `init.ts`: Added `**/site-packages/**`, `**/Lib/**`, `**/fdk-aac/**` to DEFAULT_EXCLUDE
+  - `global-init.ts`: Added Python venvs, embedded Python runtimes (Python310-313), `.cargo`, `packages`, `fdk-aac` to DEFAULT_EXCLUDED_DIRS
+
+## [1.10.1] - 2026-03-07
+
+### Fixed
+- **npm package**: Exclude token files and `futureWork.md` from published package
+- **gitignore negation patterns**: Filter out `!` negation patterns in `.gitignore` to prevent excluding all files
+  - Negation patterns (e.g., `!.vscode/settings.json`) were passed to minimatch, which interpreted `!` as "NOT this pattern" — matching ALL files
+  - This caused the entire index to be purged after initialization in projects with negation patterns (common in monorepos)
+
+## [1.10.0] - 2026-02-17
+
+### Added
+- **Note History**: Archived notes are now searchable across sessions
+  - Old notes are automatically archived when overwritten or cleared
+  - `history: true` parameter to browse archived notes (newest first)
+  - `search: "term"` parameter to search note history (case-insensitive)
+  - `limit` parameter to control how many history entries are returned (default: 20)
+
+## [1.9.1] - 2026-02-10
+
+### Added
+- **Rect Screenshot Mode**: New `mode: "rect"` for coordinate-based screen capture
+  - Specify exact `x`, `y`, `width`, `height` in pixels
+  - Useful with accessibility bounds (e.g., from WinfoMCP `get_element_details`)
+
+### Fixed
+- **Region screenshot flicker on Windows**: Fixed visual flicker during interactive region selection
+
 ## [1.9.0] - 2026-02-06
 
 ### Added

MCP-API-REFERENCE.md

@@ -32,6 +32,12 @@ Complete reference for all AiDex MCP tools.
 - [Task Management](#task-management)
   - [aidex_task](#aidex_task)
   - [aidex_tasks](#aidex_tasks)
+- [Global Search](#global-search)
+  - [aidex_global_init](#aidex_global_init)
+  - [aidex_global_status](#aidex_global_status)
+  - [aidex_global_query](#aidex_global_query)
+  - [aidex_global_signatures](#aidex_global_signatures)
+  - [aidex_global_refresh](#aidex_global_refresh)
 - [Screenshots](#screenshots)
   - [aidex_screenshot](#aidex_screenshot)
   - [aidex_windows](#aidex_windows)
@@ -568,29 +574,43 @@ Read or write session notes. Persists in the database between sessions.
 | `note` | string | - | Note to save. If omitted, reads current note |
 | `append` | boolean | - | Append to existing note instead of replacing (default: false) |
 | `clear` | boolean | - | Clear the note (default: false) |
+| `history` | boolean | - | Show archived note history, newest first (default: false) |
+| `search` | string | - | Search term to find in note history (case-insensitive) |
+| `limit` | number | - | Max history/search entries to return (default: 20) |
 
 **Operations:**
 
 | Parameters | Action |
 |------------|--------|
 | `{ path }` | Read current note |
-| `{ path, note: "..." }` | Write/replace note |
+| `{ path, note: "..." }` | Write/replace note (old note is archived) |
 | `{ path, note: "...", append: true }` | Append to note |
-| `{ path, clear: true }` | Delete note |
+| `{ path, clear: true }` | Delete note (old note is archived) |
+| `{ path, history: true }` | Browse archived notes |
+| `{ path, search: "term" }` | Search note history |
 
 **Examples:**
 ```json
 // Read note
 { "path": "." }
 
-// Write note
+// Write note (old note auto-archived)
 { "path": ".", "note": "Test glob fix after restart" }
 
 // Append to note
 { "path": ".", "note": "Also check edge cases", "append": true }
 
-// Clear note
+// Clear note (old note auto-archived)
 { "path": ".", "clear": true }
+
+// Browse note history
+{ "path": ".", "history": true }
+
+// Search past notes
+{ "path": ".", "search": "parser" }
+
+// Last 5 archived notes
+{ "path": ".", "history": true, "limit": 5 }
 ```
 
 ---
@@ -723,6 +743,119 @@ List and filter tasks in the project backlog. Returns tasks grouped by status an
 
 ---
 
+## Global Search
+
+Search across ALL indexed projects at once. Uses a global database (`~/.aidex/global.db`) that references each project's own `.aidex/index.db`. Queries use SQLite `ATTACH DATABASE` — no data copying, each project DB is the single source of truth.
+
+### aidex_global_init
+
+Scan a directory tree for AiDex-indexed projects and register them in the global database. Also detects unindexed projects by looking for project markers (`.csproj`, `package.json`, `Cargo.toml`, `go.mod`, `pyproject.toml`, `CMakeLists.txt`, etc.).
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `path` | string | Yes | Root directory to scan (e.g., `"Q:/develop"`) |
+| `max_depth` | number | No | Maximum directory depth to scan (default: 10) |
+| `tags` | string | No | Comma-separated tags for all found projects (e.g., `"privat,libs"`) |
+| `exclude` | string[] | No | Directory names or absolute paths to exclude (e.g., `["llama.cpp", "Q:/develop/external"]`) |
+| `index_unindexed` | boolean | No | Auto-index all unindexed projects with ≤500 estimated code files. Large projects (>500 files) are listed separately for user decision |
+| `show_progress` | boolean | No | Open a browser window (`http://localhost:3334`) showing live indexing progress. Only effective with `index_unindexed: true` |
+
+**Examples:**
+```json
+// Scan and register existing indexes
+{ "path": "Q:/develop", "exclude": ["llama.cpp", "node_modules"] }
+
+// Scan, register, AND auto-index all unindexed projects with progress UI
+{ "path": "Q:/develop", "index_unindexed": true, "show_progress": true }
+```
+
+**Returns:** Count of registered/new/updated/removed projects, list of unindexed projects with their markers, totals across all registered projects. When `index_unindexed` is true, also returns `indexedResults` (per-project success/failure) and `largeProjects` (projects >500 files needing user decision).
+
+---
+
+### aidex_global_status
+
+Show overview of all projects registered in the global index.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `tag_filter` | string | No | Only show projects with this tag |
+| `sort` | string | No | Sort order: `"name"` (default), `"size"` (most files first), `"recent"` (most recently indexed first) |
+
+**Example:**
+```json
+{ "sort": "recent" }
+```
+
+**Returns:** Table of all registered projects with name, path, languages, file/method/type counts, and last indexed time.
+
+---
+
+### aidex_global_query
+
+Search for a term across all registered projects. Results are cached in memory for 5 minutes.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `term` | string | Yes | Term to search for |
+| `mode` | string | No | `"exact"` (default), `"contains"`, or `"starts_with"` |
+| `tag_filter` | string | No | Only search projects with this tag |
+
+**Example:**
+```json
+{ "term": "TransparentWindow", "mode": "contains" }
+```
+
+**Returns:** Matches grouped by project, showing file paths and line numbers.
+
+---
+
+### aidex_global_signatures
+
+Search for methods or types by name across all registered projects.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `name` | string | Yes | Method or type name to search for |
+| `kind` | string | No | Filter by kind: `"method"`, `"class"`, `"struct"`, `"interface"`, `"enum"`, `"type"` |
+| `tag_filter` | string | No | Only search projects with this tag |
+
+**Example:**
+```json
+{ "name": "Render", "kind": "method" }
+```
+
+**Returns:** Matching methods (with prototype, visibility, file, line) and types (with kind, file, line), grouped by project.
+
+---
+
+### aidex_global_refresh
+
+Update statistics for all registered projects and remove projects whose paths no longer exist.
+
+**Parameters:**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `tag_filter` | string | No | Only refresh projects with this tag |
+
+**Example:**
+```json
+{}
+```
+
+**Returns:** Count of updated and removed projects, plus updated totals.
+
+---
+
 ## Screenshots
 
 ### aidex_screenshot
@@ -733,8 +866,12 @@ Take a screenshot of the screen, a window, or an interactive region selection. R
 
 | Name | Type | Required | Description |
 |------|------|----------|-------------|
-| `mode` | string | - | `fullscreen` (default), `active_window`, `window`, `region` |
+| `mode` | string | - | `fullscreen` (default), `active_window`, `window`, `region`, `rect` |
 | `window_title` | string | for mode=window | Window title substring to match (use `aidex_windows` to find titles) |
+| `x` | number | for mode=rect | X coordinate of the capture rectangle |
+| `y` | number | for mode=rect | Y coordinate of the capture rectangle |
+| `width` | number | for mode=rect | Width of the capture rectangle in pixels |
+| `height` | number | for mode=rect | Height of the capture rectangle in pixels |
 | `monitor` | number | - | Monitor index (0-based, default: primary). Only for fullscreen mode |
 | `delay` | number | - | Seconds to wait before capturing (e.g., `3` to switch windows first) |
 | `filename` | string | - | Custom filename (default: `aidex-screenshot.png`). Overwrites if exists |
@@ -748,6 +885,7 @@ Take a screenshot of the screen, a window, or an interactive region selection. R
 | `active_window` | Currently focused window | Win32 API / screencapture / xdotool+maim |
 | `window` | Specific window by title substring | EnumWindows / osascript / xdotool |
 | `region` | User draws a rectangle interactively | WinForms overlay / screencapture -i / maim -s |
+| `rect` | Capture specific coordinates (x, y, width, height) | PowerShell / screencapture / maim |
 
 **Returns:**
 - `file_path`: Absolute path to the saved PNG file
@@ -769,6 +907,9 @@ Take a screenshot of the screen, a window, or an interactive region selection. R
 // Interactive region selection
 { "mode": "region" }
 
+// Capture specific coordinates (e.g., from accessibility bounds)
+{ "mode": "rect", "x": 100, "y": 200, "width": 800, "height": 600 }
+
 // Fullscreen with delay and custom path
 { "delay": 3, "filename": "bug-report.png", "save_path": "/tmp/screenshots" }