Glosario

Definiciones breves de los términos clave de Notarium. Cada término enlaza con la página donde se explica en detalle.

Almacenamiento e identidad

file-first — el principio según el cual la fuente de verdad son los propios archivos Markdown, en el disco. El índice de búsqueda, el grafo de enlaces y todo lo derivado se pueden reconstruir a partir de los archivos; puedes tomar la carpeta e irte cuando quieras. Más en File-first.

espacio — una base de conocimiento aislada con su propio índice, grafo, búsqueda, árbol, registro de revisiones y lista de miembros. Cada usuario tiene un espacio personal no eliminable (en las páginas orientadas a agentes se le llama dominio personal). Más en Espacios y proyectos.

proyecto — una entidad ligera y opcional: una carpeta marcada con una identidad estable dentro de un espacio (la marca es un dot-file en la raíz de la carpeta). Un agente lo direcciona por su handle space/slug. Más en Espacios y proyectos.

notarium-id — un identificador de nota estable de 12 caracteres en el frontmatter. Sobrevive a mover y renombrar el archivo, de modo que los enlaces y el historial nunca se rompen. Más en Historial de versiones.

clase de nota — un conjunto de políticas de visibilidad e indexación que se deriva del lugar donde se almacena la nota (no es un campo libre): user-doc (nota de usuario, visible en todas partes), agent-memory (memoria del agente, indexada y accesible mediante recall pero oculta de las superficies orientadas al usuario), más los internos attachment, derived y profile. Más en Tipos de nota.

Acceso y agentes

principal — un sujeto de acceso generalizado: una persona o un agente de IA. Un único mecanismo de concesión para todos. Más en Modelo de acceso.

roles — membresía en un espacio: reader (lee todo), writer (edita notas), owner (gestiona la membresía). Más en Modelo de acceso.

PAT (Personal Access Token) — un token de acceso personal para agentes, que se envía en la cabecera Authorization: Bearer …. Lleva un alcance (read/write), la posibilidad de restringirlo a espacios concretos y una fecha de caducidad. El secreto se muestra exactamente una vez. Más en Conectar un agente.

pasarela MCP — el endpoint integrado POST /mcp a través del cual un agente de IA lee y escribe en la base de conocimiento con herramientas orientadas a la intención (en lugar de operaciones CRUD genéricas). Las ediciones de un agente se versionan, quedan limitadas por el acceso y se firman con procedencia. Más en Agentes y MCP.

herramienta de intención — una herramienta de la pasarela MCP que expresa una intención («buscar», «crear una nota») en lugar de una operación CRUD de bajo nivel sobre el almacenamiento. Más en Herramientas de intención.

Búsqueda

búsqueda híbrida — una fusión de tres canales: léxico (texto completo FTS/BM25, siempre activo), semántico (vectores, se activa con un flag) y un refuerzo por grafo opcional. Los resultados se combinan mediante el algoritmo RRF. Más en Búsqueda.

RRF (Reciprocal Rank Fusion) — un algoritmo que pondera y fusiona listas ordenadas (léxico + semántico + grafo) en un único conjunto de resultados sin una escala de puntuación común. Más en Búsqueda.

degradación — una capacidad que recurre a una variante más simple cuando sus dependencias no están presentes: si el stack vectorial está desactivado o no disponible, la búsqueda sigue funcionando sobre el texto completo (FTS), sin error y con el mismo resultado. Más en Configuración de la búsqueda.

Versiones y procedencia

registro de revisiones — el historial de versiones de las notas en la base de datos de metadatos (no git). Una revisión es una instantánea completa del estado; los estados idénticos se deduplican por contenido. El registro está indexado por notarium-id, así que el historial sobrevive a mover/renombrar. Más en Historial de versiones.

procedencia — la atribución de cada revisión: quién hizo la edición y cómo — una persona concreta, un agente de IA concreto o un editor de archivos externo. Más en Historial de versiones.

Despliegue

autoalojamiento — el modelo de despliegue de Notarium: un único contenedor autónomo (Node/Fastify, motor en el mismo proceso, sin servicios externos). La privacidad proviene de ser dueño del servidor y de los archivos, no de un cifrado de extremo a extremo. Más en Self-host.

Véase también

• Variables de entorno — la tabla de configuración completa.
• Referencia de atajos de teclado — distribuciones y preajustes.
• Conceptos — cómo está construido Notarium.