feat: improve PreToolUse hook relevance with multi-signal search

Replace FTS-only file retrieval with 3-signal ranking (symbol name,
file path, FTS content). Remove git signals and Bash interception
from enrichment. Update README and changelog.

Author: RaghavChamadiya

README.md

@@ -269,24 +269,25 @@ Most MCP tools are passive — the agent has to know to call them. repowise hook
 
 ### PreToolUse — every search gets graph context
 
-When your AI agent runs `Grep` or `Glob`, repowise intercepts the call and enriches it with:
+When your AI agent runs `Grep` or `Glob`, repowise intercepts the call and enriches it with the top 3 related files — found via multi-signal search (symbol name match, file path match, and full-text search on wiki content), ranked by relevance then PageRank:
 
-- **Matching files** from the wiki's full-text search index
-- **Symbols** — functions, classes, and methods in those files
-- **Importers** — who depends on this file (callers)
-- **Dependencies** — what this file imports (callees)
-- **Git signals** — hotspot status, bus factor, primary owner
+- **Symbols** — top functions, classes, and methods in each file
+- **Imported by** — who depends on this file
+- **Uses** — what this file depends on
 
-Average latency: **24ms**. No LLM calls. No network. Pure local SQLite queries.
+No LLM calls. No network. Pure local SQLite queries.
 
 ```
-[repowise] 2 related file(s) found:
+[repowise] 3 related file(s) found:
 
-  src/auth/middleware.ts
-    Symbols: class:AuthMiddleware, function:validateToken, function:refreshSession
-    Imported by: api/routes/index.ts, api/routes/payments.ts, api/routes/admin.ts
-    Depends on: auth/jwt.ts, db/sessions.ts, config/auth.ts
-    Git: HOTSPOT, bus-factor=1, owner=@alex
+  src/core/ingestion/graph.py
+    Symbols: class:GraphBuilder, method:__init__, method:build
+    Imported by: src/core/ingestion/__init__.py
+    Uses: src/core/analysis/communities.py, src/core/analysis/execution_flows.py
+
+  src/core/ingestion/__init__.py
+    Imported by: src/cli/commands/update_cmd.py, src/core/pipeline/orchestrator.py
+    Uses: src/core/ingestion/graph.py
 ```
 
 ### PostToolUse — auto-detect stale wiki

docs/CHANGELOG.md

@@ -9,6 +9,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ---
 
+## [0.3.1] — Unreleased
+
+### Changed
+- **PreToolUse hook** — replaced FTS-only file retrieval with multi-signal ranking: symbol name match (highest weight), file path match, then FTS on wiki content. Returns top 3 files instead of 5. Removed git signals (HOTSPOT, bus-factor, owner) from enrichment output — use `get_risk` for that. Removed Bash command interception. Dependencies shown as "Uses" (2 per file) alongside symbols (3) and importers (3).
+
+---
+
 ## [0.3.0] — 2026-04-13
 
 ### Added
@@ -286,7 +293,8 @@ See git history for releases prior to 0.2.0.
 
 ---
 
-[0.3.0]: https://github.com/repowise-dev/repowise/compare/v0.2.3...HEAD
+[0.3.1]: https://github.com/repowise-dev/repowise/compare/v0.3.0...HEAD
+[0.3.0]: https://github.com/repowise-dev/repowise/compare/v0.2.3...v0.3.0
 [0.2.3]: https://github.com/repowise-dev/repowise/compare/v0.2.2...v0.2.3
 [0.2.2]: https://github.com/repowise-dev/repowise/compare/v0.2.1...v0.2.2
 [0.2.1]: https://github.com/repowise-dev/repowise/compare/v0.2.0...v0.2.1