sgx-labs/statelessagent

Создаёт заметку для передачи сессии, чтобы следующая сессия продолжила с того места, где остановилась эта. Записывает, над чем вы работали, что осталось сделать и какие есть блокеры. Аргументы: summary: что было сделано за эту сессию pending: что осталось сделать (необязательно) blockers: любые блокеры или открытые вопросы (необязательно) agent: необязательное указание автора, сохраняется в frontmatter (например, 'codex') Возвращает путь к заметке для передачи.

Находит заметки, охватывающие темы, схожие с заданной заметкой. Используйте это для обнаружения связанного контекста, поиска заметок, которые могут конфликтовать, или построения более широкой картины темы. Аргументы: path: Относительный путь исходной заметки top_k: Количество похожих заметок (по умолчанию 5, максимум 100) Возвращает список связанных заметок, отсортированных по степени сходства.

Читает полное содержимое заметки. Используется после того, как search_notes возвращает релевантный результат и требуется полный текст. Пути указываются относительно корня хранилища. Аргументы: path: Относительный путь от корня хранилища (возвращается search_notes) Возвращает полное текстовое содержимое в формате Markdown.

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

Проверяет состояние и размер индекса заметок. Используйте это, чтобы убедиться, что индекс актуален, или чтобы сообщить статистику пользователю. Возвращает количество заметок, количество чанков, время последней индексации, информацию о модели эмбеддингов и размер базы данных. Если пользователь сообщает о проблемах, предложите ему запустить same doctor для диагностики. Для сообщений об ошибках направляйте его по адресу: https://github.com/sgx-labs/statelessagent/issues

Получает ознакомительный брифинг о том, что сейчас важно. Показывает недавнюю активность, открытые решения и ключевой контекст. Используется в начале сессии для понимания текущего состояния проекта. Args: max_items: Максимальное количество элементов в разделе (по умолчанию 5) Возвращает краткий брифинг, сгенерированный из содержимого хранилища. (экспериментально)

Консолидирует связанные заметки в хранилище. Объединяет дубликаты, разрешает противоречия, извлекает ключевые факты. Создаёт новые файлы знаний без изменения оригиналов. Используйте это, когда в хранилище много похожих или пересекающихся заметок. Аргументы: dry_run: Показывает предварительный просмотр того, что будет объединено, без записи файлов (по умолчанию false) threshold: Порог сходства для группировки заметок, 0.0–1.0 (по умолчанию 0.75) Возвращает сводку консолидации с найденными группами, извлечёнными фактами и разрешёнными конфликтами. (экспериментально)

Подавляет запись в памяти, чтобы она не всплывала в обычном поиске. Запись не удаляется — она помечается как подавленная и будет показываться, только если её явно запросить. Используйте это для устаревших, неверных или неуместных воспоминаний. Операция не имеет простого обратного хода: инструмента mem_restore не существует. Аргументы: path: путь к подавляемой записи (обязательно) reason: причина подавления (необязательно) Возвращает подтверждение подавления. (экспериментально)

Проверяет здоровье хранилища памяти. Возвращает оценку здоровья (0-100) и практические рекомендации. Используйте это, чтобы определить, нуждается ли хранилище в консолидации, переиндексации или очистке. Возвращает оценку здоровья, ключевые метрики и рекомендации. (экспериментально)

Получает недавно изменённые заметки. Используйте это, чтобы увидеть, что изменилось недавно или чтобы сориентироваться в начале сессии. Аргументы: limit: Количество последних заметок (по умолчанию 10, максимум 50) Возвращает список недавно изменённых заметок с названиями и путями.

Повторно сканирует и переиндексирует все заметки Markdown. Используйте это, если пользователь добавил или изменил заметки, а результаты поиска кажутся устаревшими. По умолчанию инкрементальный (заново встраивает только изменённые файлы). Аргументы: force: Заново встраивает все файлы независимо от изменений (по умолчанию false) Возвращает статистику индексации.

Записывает решение по проекту. Добавляет запись в лог решений, чтобы будущие сессии могли её найти. Аргументы: title: Короткий заголовок решения (например, 'Use JWT for auth') body: Полное описание решения — что решили, почему, какие альтернативы рассматривали status: Статус решения — 'accepted', 'proposed' или 'superseded' (по умолчанию 'accepted') agent: Необязательное указание автора в frontmatter (например, 'codex') Возвращает подтверждение.

Логирует точку трения, ошибку или идею для улучшения, обнаруженные в ходе работы. SAME отслеживает происхождение — если исходные файлы позже изменятся, элемент автоматически помечается как потенциально учтённый. Аргументы: description: Что было замечено (обязательно) area: Область кодовой базы (например, 'indexer', 'config', 'hooks') (опционально) agent: Кто это заметил (опционально) sources: Пути к связанным файлам для отслеживания происхождения (опционально) Возвращает подтверждение с путём к файлу.

Создаёт или обновляет заметку в Markdown в хранилище. Заметка записывается на диск и индексируется автоматически. Опционально указывает исходные файлы для отслеживания происхождения — SAME пометит эту заметку как устаревшую, если источники изменятся. Аргументы: path: Относительный путь внутри хранилища (например, 'decisions/auth-approach.md') content: Содержимое в формате Markdown для записи append: Если true, добавляет к существующему файлу вместо перезаписи (по умолчанию false) agent: Опциональная информация об авторе, сохраняемая в frontmatter (например, 'codex') sources: Пути к файлам, из которых получена эта заметка (опционально) Возвращает подтверждение с сохранённым путём.

Выполняет поиск сразу по нескольким зарегистрированным хранилищам. Используйте это вместо search_notes, когда нужен контекст из других проектов или межпроектный обзор. Хранилища должны быть предварительно зарегистрированы через CLI (same vault add <name> <path>). Аргументы: query: Поисковый запрос на естественном языке top_k: Количество результатов (по умолчанию 10, максимум 100) vaults: Псевдонимы хранилищ через запятую для поиска. Если не указано — ищет по всем зарегистрированным хранилищам. Неизвестные псевдонимы игнорируются без уведомления. Возвращает ранжированные результаты с заголовками, путями, фрагментами и именем исходного хранилища.

Ищет в базе знаний пользователя заметки, решения и контекст по теме. Используйте этот инструмент, когда нужно разобраться в вопросе, найти предыдущие решения или понять архитектуру проекта. Аргументы: query: Естественно-языковой поисковый запрос (например, 'подход к аутентификации', 'решения по схеме БД') top_k: Количество результатов (по умолчанию 10, максимум 100) Возвращает ранжированный список подходящих заметок с заголовками, путями и фрагментами текста.

Ищет в базе знаний пользователя с фильтрами по метаданным. Используйте, когда нужно сузить результаты по домену (например, 'engineering'), рабочему потоку (например, 'api-redesign'), тегам, атрибуции агента, состоянию доверия или типу контента. Аргументы: query: Поисковый запрос на естественном языке top_k: Количество результатов (по умолчанию 10, не более 100) domain: Фильтр по домену (например, 'engineering', 'product') workstream: Фильтр по рабочему потоку или названию проекта tags: Теги, разделённые запятыми, для фильтрации agent: Фильтр по атрибуции агента (например, 'codex', 'claude') trust_state: Фильтр по состоянию доверия (validated, stale, contradicted, unknown) content_type: Фильтр по типу контента (decision, handoff, note, research) Возвращает отфильтрованный ранжированный список.