Glossaire

Définitions courtes des termes clés de Notarium. Chaque terme renvoie à la page qui le développe en détail.

Stockage et identité

file-first — le principe selon lequel la source de vérité, ce sont les fichiers Markdown eux-mêmes, sur le disque. L'index de recherche, le graphe de liens et tout ce qui en dérive sont reconstructibles à partir des fichiers ; vous pouvez récupérer le dossier et partir à tout moment. Plus de détails dans File-first.

espace — une base de connaissances isolée, avec son propre index, son graphe, sa recherche, son arborescence, son journal des révisions et sa liste de membres. Chaque utilisateur dispose d'un espace personnel non supprimable (sur les pages destinées aux agents, on l'appelle domaine personnel). Plus de détails dans Espaces et projets.

projet — une entité légère et optionnelle : un dossier marqué doté d'une identité stable au sein d'un espace (le marqueur est un dot-file à la racine du dossier). Un agent l'adresse via le handle space/slug. Plus de détails dans Espaces et projets.

notarium-id — un identifiant de note stable, de 12 caractères, dans le frontmatter. Il survit au déplacement et au renommage du fichier, de sorte que les liens et l'historique ne se rompent jamais. Plus de détails dans Historique des versions.

classe de note — un ensemble de politiques de visibilité et d'indexation dérivé de l'endroit où la note est stockée (et non un champ libre) : user-doc (note utilisateur, visible partout), agent-memory (mémoire d'agent, indexée et accessible via recall mais masquée des surfaces destinées à l'utilisateur), plus les classes internes attachment, derived et profile. Plus de détails dans Types de notes.

Accès et agents

principal — un sujet d'accès généralisé : une personne ou un agent IA. Un seul mécanisme d'octroi pour tous. Plus de détails dans Modèle d'accès.

rôles — l'appartenance à un espace : reader (lit tout), writer (édite les notes), owner (gère l'appartenance). Plus de détails dans Modèle d'accès.

PAT (Personal Access Token) — un jeton d'accès personnel pour les agents, transmis dans l'en-tête Authorization: Bearer …. Il porte une portée (read/write), une restriction facultative par espace et une date d'expiration. Le secret n'est affiché qu'une seule fois. Plus de détails dans Connecter un agent.

passerelle MCP — l'endpoint intégré POST /mcp par lequel un agent IA lit et écrit dans la base de connaissances à l'aide d'outils orientés intention (plutôt que d'opérations CRUD génériques). Les modifications d'un agent sont versionnées, bornées par ses accès et signées avec leur provenance. Plus de détails dans Agents et MCP.

outil d'intention — un outil de la passerelle MCP qui exprime une intention (« trouver », « créer une note ») plutôt qu'une opération CRUD bas niveau sur le stockage. Plus de détails dans Outils d'intention.

Recherche

recherche hybride — la fusion de trois canaux : lexical (plein texte FTS/BM25, toujours actif), sémantique (vecteurs, activé par un flag) et un graph boost facultatif. Les résultats sont combinés par l'algorithme RRF. Plus de détails dans Recherche.

RRF (Reciprocal Rank Fusion) — un algorithme qui pondère et fusionne des listes classées (lexical + sémantique + graphe) en un unique jeu de résultats, sans échelle de score commune. Plus de détails dans Recherche.

dégradation — une capacité qui se replie sur une variante plus simple lorsque ses dépendances sont absentes : si la pile vectorielle est désactivée ou indisponible, la recherche continue de fonctionner sur le plein texte (FTS) — sans erreur, et avec le même résultat. Plus de détails dans Configuration de la recherche.

Versions et provenance

journal des révisions — l'historique des versions des notes dans la base de métadonnées (pas git). Une révision est un instantané complet de l'état ; les états identiques sont dédupliqués par contenu. Le journal est indexé par notarium-id, de sorte que l'historique survit au déplacement et au renommage. Plus de détails dans Historique des versions.

provenance — l'attribution de chaque révision : qui a effectué la modification et comment — une personne précise, un agent IA précis, ou un éditeur de fichiers externe. Plus de détails dans Historique des versions.

Déploiement

self-host — le modèle de déploiement de Notarium : un unique conteneur autonome (Node/Fastify, moteur in-process, sans services externes). La confidentialité tient au fait que vous possédez le serveur et les fichiers, non à un chiffrement de bout en bout. Plus de détails dans Auto-hébergement.

Voir aussi

• Variables d'environnement — le tableau de configuration complet.
• Référence des raccourcis clavier — dispositions et préréglages.
• Concepts — comment Notarium est construit.