Безопасность

NOUZ работает с живой Markdown-базой, поэтому главное правило простое: читать и предлагать можно широко, записывать — только осознанно и точечно.

Сначала чтение

Для первого прохода используйте действия, которые показывают состояние базы:

• list_files — увидеть карту файлов и фильтры по уровню, знаку или папке;
• read_file — прочитать заметку вместе с YAML;
• get_parents и get_children — проверить место заметки в графе;
• suggest_metadata и suggest_parents — получить предложения без записи.

Так агент видит структуру, но не меняет текст заметок и не принимает решения за вас.

Запись только после проверки

Для безопасных правок используйте update_metadata: он меняет YAML-блок и сохраняет тело заметки. Это основной путь для type, level, sign, artifact_sign, tags, parents и parents_meta.

write_file нужен, когда вы действительно хотите создать или заменить файл. Перед записью сервер проверяет граф на циклы и синхронизирует связи, но само решение о записи остаётся за вами.

Режим только чтения

Если базе нужен доступ для анализа, но любые записи должны быть заблокированы, включите:

NOUZ_READ_ONLY=true

В этом режиме остаются чтение, навигация, поиск и предложения. Инструменты записи, массовой индексации и пересчёта скрываются или блокируются.

Если нужен кэш в режиме только чтения, можно отдельно разрешить:

NOUZ_CACHE_WRITE=true

Граница индекса

NOUZ хранит служебный индекс в SQLite: метаданные, связи графа, эмбеддинги, эталонные векторы, core_mix и автоматические признаки. Это вычисленный слой рядом с базой, а не замена вашим Markdown-файлам.

YAML остаётся явной частью базы. Семантические мосты, теги-кандидаты и возможные родители сначала возвращаются как предложения.

Хороший порядок работы

1. Подключить папку и проверить путь.
2. Прочитать несколько ключевых заметок.
3. Посмотреть родителей, детей и файлы без разметки.
4. Получить предложения для небольшой партии.
5. Записать только те изменения, которые вы действительно приняли.

Так NOUZ помогает агенту ориентироваться в базе, но не превращается в автоматический переписчик структуры.