Aurora Nexus
Aurora NexusRéférence technique

Changelog — Aurora Nexus (MVP)

(depuis `CHANGELOG.md`)

Ce changelog résume les principales évolutions fonctionnelles et correctifs visibles côté utilisateur (UI) et côté backend (API/ingestion).

1.0.17 — jeudi 04 juin 2026

Installation

  • Ajout du wrapper racine install.sh pour lancer un parcours one-pass.
  • Séparation explicite des modes server (VPS public, domaine, HTTPS, Caddy/reverse-proxy) et local (poste Mac/Windows/Linux, navigateur local, sans DNS ni Caddy).
  • Réorganisation de la documentation d'installation en sous-menus Local et Serveur, avec prérequis et méthodes distincts.
  • Clarification Caddy : recommandé côté serveur, ignoré en local, et non installé automatiquement par le wizard.
  • Ajout du preset wizard --preset server|local, avec dry-run non mutateur même si Caddy est présent.
  • Alignement du rendu .env wizard avec les variables de référence, dont NEXT_PUBLIC_DOCS_BASE_URL et les paramètres KG/Meta KG récents.

Meta KG Applications et MCP Nexus

  • Stabilisation documentaire de la séparation entre KG documentaire et Code KG / Meta KG applicatif.
  • Ajout du pack MCP nexus-api pour exposer l'API Nexus et le RAG en OAuth utilisateur, distinct des deux MCP KG.
  • Ajout du connecteur MCP nexus-code-kg V3 pour les workflows Codex/SR : lecture du graphe, contexte d'anomalies, contexte patch, régénération contrôlée et comparaison avant/après.
  • Ajout du connecteur MCP nexus-doc-kg en lecture seule pour les usages documentaires : filtres caller_app, source_app, workspace et project, sans tool de régénération.
  • Publication des endpoints MCP publics dédiés pour connecteurs LLM compatibles MCP, avec authentification bearer token hors dépôt.
  • Alignement OpenAI/MCP : schemas de sortie, structuredContent et annotations de lecture/mutation sur les tools.
  • Clarification du flux attendu : Code KG pour guider Codex, lecture réelle du code avant patch, tests, puis régénération et comparaison du graphe après clôture de lot SR.

Documentation

  • Ajout de la section 08_Meta_KG dans l'index documentaire Nexus.
  • Ajout de la page consolidée Serveurs MCP Nexus, couvrant nexus-api, nexus-code-kg, nexus-doc-kg et le rôle du Nexus SDK.
  • Actualisation des README principaux et de la roadmap pour refléter les surfaces KG/MCP récentes.
  • Consolidation progressive des addenda Meta KG dans les pages canoniques.

1.0.16 — mercredi 20 mai 2026

Projets par défaut

  • Ajout d'un statut projet par défaut par couple source_app + workspace.
  • Ajout du champ projects_config.is_default, des migrations 58_ADD_PROJECTS_DEFAULT.sql / 59_HARDEN_PROJECTS_DEFAULT.sql et de l'exposition API is_default.
  • Durcissement DB : un seul projet par défaut actif est garanti par workspace, avec backfill déterministe des projets existants.
  • Mise à jour de l'admin projets pour définir un projet par défaut, l'afficher en badge/étoile et empêcher la désactivation ou suppression du projet par défaut.
  • Les listes publiques de projets actifs renvoient désormais le projet par défaut en premier.

Correctifs UI

  • Correction de l'hydratation React au chargement Nexus : le script d'initialisation du thème est rendu dans <head>, ce qui supprime les erreurs console React #418 / #423.
  • Correction de deux clés i18n françaises manquantes dans l'admin : admin.settings.assistantScraper et admin.sourceApps.actionsMenu.assistantRag.
  • Mise à jour de l'affichage de version Nexus en 1.0.16.

1.0.15 — mercredi 20 mai 2026

Suivi des connexions utilisateurs

  • Ajout d'un journal structuré des événements de connexion utilisateur via la table user_auth_events.
  • Journalisation des connexions réussies/refusées, déconnexions, OAuth et SSO Pilot, sans stocker de token, mot de passe ou payload sensible.
  • Ajout de l'endpoint admin /api/admin/users/{user_id}/auth-events avec fallback historique depuis user_sessions et last_login_at.
  • Ajout du menu Administration > Utilisateurs > Actions > Logs avec une vue formatée par utilisateur.
  • Masquage de l'adresse IP côté API/UI et affichage d'un contexte synthétique.
  • Installation locale de la méthode SR Codex pour cadrer les tâches Aurora avec mémoire de travail, cartographie et skills projet.
  • Mise à jour de l'affichage de version Nexus en 1.0.15.

1.0.14 — mercredi 20 mai 2026

Apparence utilisateur

  • Ajout d'une section Mon compte > Apparence pour choisir une palette Aurora et le mode clair/sombre.
  • Persistance des préférences d'apparence par utilisateur via /api/preferences.
  • Application globale du thème Aurora au chargement de l'UI pour conserver l'apparence choisie après rechargement.
  • Ajout de la migration 56_ADD_USER_APPEARANCE_PREFERENCES.sql et alignement du schéma users.
  • Mise à jour de l'affichage de version Nexus en 1.0.14.

1.0.13 — vendredi 08 mai 2026

Knowledge Graph Nexus

  • Ajout d'un panneau de pilotage dans Paramètres > Knowledge Graph : mode actif, statut du dernier graphe, compteurs nœuds/relations et date du rebuild.
  • Ajout d'actions UI directes pour ouvrir la carte Knowledge Graph et reconstruire le graphe.
  • Ajout d'un bloc benchmark indiquant le poids KG et le nombre maximal de documents ajoutés par expansion.
  • Correction runtime : KG_RETRIEVAL_MAX_EXTRA_DOCS rafraîchit désormais le contexte API après modification du setting.

1.0.12 — vendredi 08 mai 2026

Knowledge Graph Nexus

  • Enrichissement du corpus kg_tests : 6 documents supplémentaires et 6 nouvelles questions difficiles orientées expansion KG.
  • Ajout de scénarios de benchmark reception/réserves chantier, retenue occupant Fiat et masses calculateur Peugeot.
  • Benchmark étendu : 17 cas au total, dont 11 difficiles; l'expansion KG ajoute des citations utiles sans fuite de scope.

1.0.11 — vendredi 08 mai 2026

Knowledge Graph Nexus

  • Ajout de l'expansion documentaire KG expérimentale derrière KG_RETRIEVAL_EXPAND_ENABLED=false par défaut.
  • Ajout du réglage KG_RETRIEVAL_MAX_EXTRA_DOCS pour borner le nombre de documents ajoutés par le KG.
  • L'expansion reste strictement filtrée par tenant/source_app/workspace/project et ne peut ajouter que des chunks Qdrant issus de documents voisins du graphe.
  • Le benchmark expose désormais le nombre de citations ajoutées via expansion KG.

1.0.10 — vendredi 08 mai 2026

Knowledge Graph Nexus

  • Ajout d'un signal de scoring KG similar_query_citations : les documents cités par des requêtes historiques lexicalement proches peuvent recevoir un bonus explicable.
  • Transmission de la requête de retrieval courante au scorer KG pour enrichir score_breakdown et kg_reasons.
  • Correction du benchmark ops/kg_rag_compare.py : un changement d'ordre dans le top-3 contribue désormais à l'influence KG même si le set de citations reste identique.
  • Calibration benchmark kg_tests : à poids prudent 0.15, le KG explique sans perturber ; à poids 0.30, 3 top-3 changent sans fuite de scope.

1.0.9 — vendredi 08 mai 2026

Knowledge Graph Nexus

  • Enrichissement du benchmark kg_tests avec documents leurres par projet pour rendre les tests plus discriminants.
  • Ajout d'un seed d'historique contrôlé dans ops/kg_tests_prepare.py afin de créer des liens thread -> query -> cited -> document.
  • Ajout de nouveaux cas difficiles : follow-up elliptique Fiat sécurité et question Peugeot capteurs/calage.
  • Premier benchmark enrichi : influence KG mesurable sur un cas difficile, sans citation hors scope ni dégradation du score qualité.

1.0.8 — jeudi 07 mai 2026

Knowledge Graph Nexus

  • Ajout d'une section admin Knowledge Graph dans les paramètres UI pour piloter KG_ENABLED, le scoring KG, son poids et le flag d'expansion.
  • Ajout du corpus versionné kg_tests pour benchmarks progressifs RAG vs RAG + KG.
  • Ajout du script ops/kg_tests_prepare.py pour créer les workspaces/projets/documents de test et indexer les fixtures dans Qdrant.
  • Ajout des cas de benchmark docs/benchmark/kg_tests/cases.json, avec niveaux facile, moyen, difficile et extraits réels contrôlés.

1.0.7 — jeudi 07 mai 2026

Knowledge Graph Nexus

  • Renforcement du scoring KG relationnel derrière KG_RETRIEVAL_SCORE_ENABLED=false par défaut.
  • Ajout d'un poids configurable KG_RETRIEVAL_SCORE_WEIGHT pour garder Qdrant dominant dans le reranking.
  • Ajout de diagnostics optionnels par citation : kg_score, score_breakdown, kg_reasons, rang avant/après.
  • Enrichissement du benchmark RAG vs RAG + KG avec métriques de top-3, documents promus/démotés et scores KG.

1.0.6 — jeudi 07 mai 2026

Distribution / installation

  • Retrait du pack documentaire et des exports LFS docs/pack_metier/recrutement/ du dépôt produit.
  • Allègement du clone pour les nouvelles installations Nexus : le projet recrutement est désormais maintenu hors de ce dépôt.

1.0.5 — jeudi 07 mai 2026

Knowledge Graph Nexus

  • Ajout du Knowledge Graph structurel Postgres : versions de graphe, nœuds, relations et rebuild manuel admin.
  • Ajout des endpoints /api/knowledge-graph/overview, /api/knowledge-graph/subgraph, /api/knowledge-graph/neighbors/{node_id} et /api/knowledge-graph/rebuild.
  • Ajout d'un dashboard d'administration Knowledge Graph avec visualisation ECharts, filtres et panneau de détail.
  • Préparation du scoring KG dans le retrieval RAG derrière KG_RETRIEVAL_SCORE_ENABLED=false.
  • Ajout du script de benchmark ops/kg_rag_compare.py pour comparer RAG normal et RAG + KG.

Ingestion / workspaces

  • Ajout des profils d'ingestion par workspace et du suivi de heartbeat/stages pour les corpus lourds.
  • Documentation opérationnelle ajoutée dans docs/05_Operations/35-Workspace-Ingestion-Profiles.md.

Documentation

  • Ajout de la référence Knowledge Graph dans docs/07_Reference-Tech/55-Knowledge-Graph.md.
  • Ajout des variables d'environnement KG dans la référence .env.

1.0.4 — vendredi 27 février 2026

Aide / visibilité de version

  • Ajout de l’affichage de la version applicative dans Aide → carte Changelog (badge vX.Y.Z à côté du titre).
  • La valeur affichée provient de la variable d’environnement NEXT_PUBLIC_AURORA_NEXUS_VERSION.

Déploiement / configuration

  • Ajout de NEXT_PUBLIC_AURORA_NEXUS_VERSION dans le build UI (docker-compose.yml, ui/Dockerfile) et dans .env.example.
  • Documentation de la variable ajoutée dans docs/03_Configuration/10-ENV-Reference.md.

1.0.3 — lundi 19 janvier 2026

RAG “multi-tours” (apps externes & UI)

  • Support de follow-ups robustes (“détaille S2 / point B / 2e point”) sans réinjecter l’historique brut dans la requête.
  • Ajout d’un état minimal par conversation (thread_state) basé sur un bloc SUIVI machine-parsable (non traduit) en fin de livrable.

Backend / API

  • POST /api/query accepte thread_id (optionnel, recommandé) pour corréler les requêtes et activer la résolution de follow-ups.
  • Prompt d’appel LLM rendu plus déterministe : un message user unique avec QUESTION + QUESTION_CLARIFIEE_POUR_RETRIEVAL + CONTEXT délimité.

Observabilité / DB

  • Ajout de champs de diagnostic dans queries_log : thread_id, retrieval_query_final, retrieval_queries_tried, condense_used, retrieval_retry_count, etc.
  • Ajout des champs followup_* pour tracer les décisions de résolution (followup_resolved, followup_section_id, followup_ref_type).

1.0.2 — vendredi 09 janvier 2026

UI Admin (navigation & lisibilité)

  • Suppression d’une navbar admin intermédiaire (évite la confusion “pages vs paramètres”).
  • Stabilisation de la navigation Paramètres : menu gauche unique sur les 12 sections historiques (Général, Logs, Rétention, Cache LLM, Modèles & providers, Clés API, Modèles IA, RAG & assistant, Assistant, Pipeline ingestion, Services connectés, Historique).

Prompts

  • Prompt système global ASSISTANT_CORE : affichage direct (aperçu) dans l’UI + édition/versionning.

Registry caller_app

  • Gestion UI des applications appelantes (caller_app) intégrée aux Paramètres (section Services connectés).
  • Filtrage caller_app étendu aux vues Documents / Ingestion / Observabilité (selon pages).

Backend / DB (robustesse)

  • Ajout/alignement des colonnes caller_app sur les entités d’ingestion/documents (compat avec filtres UI).
  • Correction d’un cas de 500 Postgres (“column caller_app does not exist”) sur les endpoints de listing si schéma ancien : migrations requises.

1.0.1 — lundi 05 janvier 2026

Observabilité & feedback

  • Ajout d’un badge Feedback (Oui/Non) dans les tableaux de requêtes (dashboard + page stats requêtes), avec modale de détail (question, réponse, feedback, citations).
  • Ajout d’un filtre Feedback : Tous / Oui / Non / Aucun feedback.
  • Ajout d’une pagination numérotée (en plus de Précédent/Suivant).
  • Amélioration lisibilité : badge Non en rouge, raisons négatives affichées en clair (traduction UI).

Documents

  • Documents en erreur d’ingestion : exclusion par défaut de la liste des documents (option include_errors=true côté API si besoin).
  • Correction d’un bug SQL (enum doc_status) qui pouvait provoquer un 500 sur la liste des documents.

Ingestion (robustesse)

  • Amélioration de la robustesse des upserts Qdrant : timeout configurable + batching + retry.
  • Propagation du statut error côté documents quand un job passe en failed.

Notes

  • Version MVP : la granularité et la fréquence des entrées changelog pourront évoluer (V1 : automatisation, liens tickets, etc.).

Intégration : Aurora Bot → Nexus (query + streaming)

intégration Aurora Bot → Nexus (query + streaming SSE)

Conversations multi-tours (follow-ups) — `thread_id` + bloc `SUIVI`

`thread_id` + bloc `SUIVI` + résolution des follow-ups (apps externes)

On this page

1.0.17 — jeudi 04 juin 2026InstallationMeta KG Applications et MCP NexusDocumentation1.0.16 — mercredi 20 mai 2026Projets par défautCorrectifs UI1.0.15 — mercredi 20 mai 2026Suivi des connexions utilisateurs1.0.14 — mercredi 20 mai 2026Apparence utilisateur1.0.13 — vendredi 08 mai 2026Knowledge Graph Nexus1.0.12 — vendredi 08 mai 2026Knowledge Graph Nexus1.0.11 — vendredi 08 mai 2026Knowledge Graph Nexus1.0.10 — vendredi 08 mai 2026Knowledge Graph Nexus1.0.9 — vendredi 08 mai 2026Knowledge Graph Nexus1.0.8 — jeudi 07 mai 2026Knowledge Graph Nexus1.0.7 — jeudi 07 mai 2026Knowledge Graph Nexus1.0.6 — jeudi 07 mai 2026Distribution / installation1.0.5 — jeudi 07 mai 2026Knowledge Graph NexusIngestion / workspacesDocumentation1.0.4 — vendredi 27 février 2026Aide / visibilité de versionDéploiement / configuration1.0.3 — lundi 19 janvier 2026RAG “multi-tours” (apps externes & UI)Backend / APIObservabilité / DB1.0.2 — vendredi 09 janvier 2026UI Admin (navigation & lisibilité)PromptsRegistry caller_appBackend / DB (robustesse)1.0.1 — lundi 05 janvier 2026Observabilité & feedbackDocumentsIngestion (robustesse)Notes