feat(ai): catalogue d'outils lecture & recherche (#79 phase C)

2026-09-11 20:33:15 -04:00
parent 7cf7d33b6d
commit 31b65ade5b
13 changed files with 1220 additions and 524 deletions
@@ -93,21 +93,25 @@ ObsiGate possède aujourd'hui **deux sous-systèmes IA** qui partagent la même

 Extraire la logique métier des routes de `backend/main.py` vers des fonctions réutilisables (services). Les routes REST, l'agent in-app et le serveur MCP appellent ces mêmes services.

-**Nouveau module `backend/services/` (A2 — lecture/recherche) :**
+**Nouveau module `backend/services/` (A2 lecture/recherche + C) :**

 ```
 backend/services/
 ├── errors.py      # ServiceError (code + status HTTP)
 ├── paths.py       # resolve_safe_path (anti path-traversal, source unique)
-├── vaults.py      # list_accessible_vaults, browse_directory, get_vault_root
+├── vaults.py      # list_accessible_vaults, browse_directory, get_vault_root, list_all_files
 ├── files.py       # read_raw_file, read_file_text (redaction + quota)
-└── search.py      # search_vaults (pagination), list_tags
+├── search.py      # search_vaults (pagination), list_tags, advanced_search_vaults, search_paths
+├── backups.py     # get_backup_dir, list_backup_files, diff_backup
+├── graph.py       # get_graph (nodes/edges, wikilinks)
+└── recent.py      # list_recent, humanize_mtime
 ```

-Les routes `/api/vaults`, `/api/browse/{vault}`, `/api/file/{vault}/raw`, `/api/search` et
-`/api/tags` en sont de simples wrappers, tout comme les outils `list_vaults`, `list_directory`,
-`read_file`, `search_fulltext` et `list_tags`. Un `ServiceError` est traduit en `HTTPException`
-(handler global de `backend/main.py`) ou en `ToolError` (`backend/tools/registry.py`).
+Les routes `/api/vaults`, `/api/browse/{vault}`, `/api/file/{vault}/raw`, `/api/search`, `/api/tags`,
+`/api/recent`, `/api/vault/{vault}/files`, `/api/file/{vault}/backups`, `/api/file/{vault}/diff`,
+`/api/graph/{vault}`, `/api/tree-search` et `/api/search/advanced` en sont de simples wrappers, tout
+comme les outils correspondants du catalogue (phase C). Un `ServiceError` est traduit en
+`HTTPException` (handler global de `backend/main.py`) ou en `ToolError` (`backend/tools/registry.py`).

 **Nouveau module `backend/tools/` :**

@@ -306,7 +310,7 @@ Voir `docs/ROADMAP.md` (item dédié) pour le détail des activités.
 ## 9. Références

 - `backend/ai.py`, `backend/ai_routes.py` — couche fournisseurs + actions éditeur
- `backend/services/` — logique métier partagée (vaults, files, search) consommée par les routes et les outils
+- `backend/services/` — logique métier partagée (vaults, files, search, backups, graph, recent) consommée par les routes et les outils
 - `backend/ai_chat.py` — chat completion provider-agnostique avec tool calling et streaming (OpenAI-compat + Gemini)
 - `backend/agent/loop.py` — agent loop in-app (multi-étapes, LLM injectable)
 - `backend/bookslm.py`, `backend/bookslm_routes.py` — assistant contextuel (+ endpoint `/agent`)