Типы заметок
У каждой заметки есть класс — он задаёт, где заметка видна и как индексируется. Класс — это не свободная метка во frontmatter, которую можно проставить руками: это набор политик, который система выводит из места хранения и применяет сама. В API-ответе класс — признак только для чтения.
Класс — это набор политик
За классом стоит набор политик — да/нет по каждой: индексируется ли заметка, попадает ли в граф, ленту, дерево, пользовательский поиск, доступна ли recall агента, версионируется ли, реплицируется ли. Главное: видимость проверяется в одном месте, а не фильтром, который надо не забыть добавить в каждый запрос. «Спрятать в выдаче» и «исключить из индекса» — разные вещи, и Notarium не путает их.
Идентичность заметки — notarium-id, а не путь. Поэтому перенос или переименование не меняют класс молча и не рвут индексы.
Реестр классов
| Класс | Статус | Видимость |
|---|---|---|
user-doc | живой | Виден везде: дерево, лента, граф, поиск. Класс по умолчанию для всего пользовательского контента. |
agent-memory | живой | Индексируется и доступен recall агента, но скрыт из пользовательских поверхностей; виден владельцу отдельной секцией. |
attachment | несёт политики | Вложения — полноценные данные, но как знание не индексируются: в поиск попадают только .md-файлы. |
derived | несёт политики | Регенерируемые артефакты (превью, рендеры); в индекс не попадают. |
profile | живой | Скрыт отовсюду, где вы ищете и просматриваете заметки; доступен только через Settings → Profile и агенту в start_session. |
Два класса, с которыми вы работаете
На практике живут и наполняются два класса.
user-doc — ваши заметки. Класс по умолчанию: свободно организуется в дереве, попадает в поиск, граф и ленту. Именно сюда пишет и человек через редактор, и агент через create_note.
agent-memory — память агента. Это читаемые заметки, а не скрытая база: агент дозаписывает наблюдения в файл-на-категорию, а не плодит микрофайлы. Память хранится в отдельной служебной папке .notarium/memory/, поэтому не смешивается с вашим деревом и не конфликтует с вашими папками.
Вы читаете, правите и удаляете содержимое памяти — это ваш аудит и контроль над тем, что могло попасть в контекст (в истории видно, кто и что записал). Но вы её не реорганизуете: раскладкой владеет агент (плоский набор категорий плюс производный индекс). Перенос безопасен технически — запрет реорганизации продуктовый, чтобы модель памяти оставалась предсказуемой.
Индекс памяти — производный: он собирается из поля summary каждого memory-файла и пересобирается полным повторным сканированием. Он загружается сразу в start_session, а сами файлы подтягиваются по запросу через recall. Подробнее — Память агента.
profile — «о себе»
Отдельный класс для заметки-профиля: человеческий контент о вас (написали это вы, а не агент). Он скрыт отовсюду, где вы ищете и просматриваете заметки, и достаётся только двумя путями — через Settings → Profile и загрузкой агенту в start_session по идентификатору. Это не память агента, а курируемая вами карточка контекста.
Класс выводится из места хранения и задаётся системой — агент не выбирает ни папку, ни класс. Как это связано с изоляцией и адресацией, см. Пространства и проекты.