Архитектурные решения

Unified mutation pipeline

Create / edit / relationship changes идут через единый propose_changes flow и Human Review.

Brainstorm ≠ canon

Творческие идеи не должны автоматически записываться в мир. Явное намерение пользователя добавить/создать переводит запрос в mutation flow.

Graph is source of truth for relationships

Связи читаются из graph/EdgeStore, а не выводятся из embedding-текста сущностей.

Hybrid retrieval

Для поиска используются lexical + dense контуры; точные списки и подсчёты не должны зависеть от semantic top-k.

Provider abstraction

Agent code запрашивает typed result через общий StructuredGenerator; provider-specific compatibility остаётся в LLM layer.

Как дополнять

На каждое важное решение фиксируем: что решили, почему, какие альтернативы отбросили и что заставит пересмотреть решение.