Tipos de nota
Cada nota tiene una clase: determina dónde es visible la nota y cómo se indexa. La clase no es una etiqueta de texto libre en el frontmatter que puedas fijar a mano: es un conjunto de políticas que el sistema deduce del lugar donde se guarda la nota y aplica por su cuenta. En una respuesta de la API, la clase es de solo lectura.
La clase es un conjunto de políticas
Detrás de cada clase hay un conjunto de políticas, un sí o un no para cada una: si la nota se indexa, si aparece en el grafo, en el Feed, en el árbol, en la búsqueda que ve el usuario, si está disponible para el recall de un agente, si se versiona, si se replica. Lo clave: la visibilidad se comprueba en un único punto, no mediante un filtro que tienes que acordarte de añadir a cada consulta. «Ocultar en los resultados» y «excluir del índice» son cosas distintas, y Notarium nunca las confunde.
La identidad de una nota es su notarium-id, no su ruta. Por eso moverla o renombrarla nunca cambia la clase de forma silenciosa ni rompe los índices.
El registro de clases
| Clase | Estado | Visibilidad |
|---|---|---|
user-doc | activa | Visible en todas partes: árbol, Feed, grafo, búsqueda. La clase por defecto para todo el contenido del usuario. |
agent-memory | activa | Indexada y disponible para el recall de un agente, pero oculta de las superficies que ve el usuario; visible para el propietario en una sección aparte. |
attachment | lleva políticas | Los adjuntos son datos de pleno derecho, pero no se indexan como conocimiento: solo los archivos .md son buscables. |
derived | lleva políticas | Artefactos regenerables (vistas previas, renderizados); no llegan al índice. |
profile | activa | Oculta en todas partes donde buscas y navegas notas; accesible solo a través de Settings → Profile y para el agente en start_session. |
Las dos clases con las que trabajas
En la práctica, dos clases se mantienen activas y siguen llenándose.
user-doc: tus notas. La clase por defecto: se organiza con libertad en el árbol y alimenta la búsqueda, el grafo y el Feed. Es exactamente donde escriben tanto una persona (a través del editor) como un agente (a través de create_note).
agent-memory: la memoria del agente. Son notas legibles, no un almacén oculto: el agente va añadiendo observaciones a un archivo por categoría en lugar de generar microarchivos. La memoria vive en una carpeta de servicio aparte, .notarium/memory/, para que no se mezcle con tu árbol ni choque con tus carpetas.
Tú lees, editas y eliminas el contenido de la memoria: así es como auditas y controlas lo que pudo llegar al contexto (el historial muestra quién escribió qué). Pero no la reorganizas: la disposición pertenece al agente (un conjunto plano de categorías más un índice derivado). Mover cosas es técnicamente seguro; la prohibición de reorganizar es una decisión de producto, para que el modelo de memoria siga siendo predecible.
El índice de memoria es derivado: se compone del campo summary de cada archivo de memoria y se reconstruye con un reescaneo completo. Se carga de inmediato en start_session, mientras que los archivos en sí se traen bajo demanda a través de recall. Más en Memoria del agente.
profile: «sobre ti»
Una clase dedicada a la nota de perfil: contenido sobre ti escrito por una persona (lo escribes tú, no el agente). Está oculta en todas partes donde buscas y navegas notas, y solo se alcanza de dos maneras: a través de Settings → Profile y haciendo que start_session la cargue en el contexto del agente por identificador. Esto no es la memoria del agente, sino una tarjeta de contexto que tú mantienes.
La clase se deduce del lugar donde se guarda la nota y la fija el sistema: el agente no elige ni la carpeta ni la clase. Para ver cómo se relaciona esto con el aislamiento y el direccionamiento, consulta Espacios y proyectos.