Witness

ИИ-агенты могут действовать. Witness делает их работу подотчётной.

Модель может писать код, вызывать инструменты и передавать работу другой модели. Но когда чат исчезает, что остаётся?

Witness превращает работу агентов в долговечную, проверяемую память проекта: решения, доказательства, результаты, записи, идентичность и историю — доступную через MCP.

Строитель может сказать «готово». Witness сохраняет, что было решено, что фактически произошло и что следующий агент может проверить.

Запустить реальное демо · Изучить дорожную карту · Установить v0.1.0

Related MCP server: Cruxible Core

Режим отказа

Без общего слоя доказательств мультиагентная система постепенно превращается в кучу самоуверенных транскриптов:

Planner:   “Build the release.”
Builder:   “Done.”
Validator: “Which bytes? Which requirements? Why this design?”
Next run:  “I have no context from the previous chat.”
Owner:     reconstructs everything by hand.

С Witness долговечным объектом является не разговор, а засвидетельствованное состояние проекта.

Увидеть систему в действии

sequenceDiagram
    actor Owner
    participant Planner
    participant Builder
    participant Validator
    participant Witness
    participant NextAgent as Next agent / model

    Owner->>Planner: Ship a validated release
    Planner->>Witness: Record decision + acceptance rule
    Planner->>Builder: Build exact candidate
    Builder->>Witness: Record outcome + evidence references
    Validator->>Witness: Read decision and outcome
    Validator->>Witness: Verify or dispute result
    NextAgent->>Witness: Restore bounded project context
    Witness-->>NextAgent: Why + what happened + current evidence

Репозиторий включает реальный локальный поток MCP. Он создаёт временную базу данных, использует отдельные подписанные синтетические идентичности строителя и валидатора, записывает решение и результат, переводит результат из recorded в verified, а затем восстанавливает контекст проекта.

[1/3] Decision witnessed: builder cannot validate its own release
[2/3] Outcome verified by a distinct validator identity
[3/3] Project context restored from the database
WITNESS_DEMO_PASS decisions=1 outcomes=1 outcome_status=verified distinct_validator=true context_restored=true

Класс доказательства: реальный локальный продуктовый поток. Демо использует реальный публичный MCP-сервер и слой персистентности с синтетическими учётными данными. Это не облачный скриншот и не симулированный ответ.

Запустите реальное демо

git clone https://github.com/MaximilianoColoma/witness.git
cd witness
uv sync --locked
uv run python examples/coordinated_autonomy_demo.py

Что это даёт

Подотчётные строители

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

Непрерывность, не зависящая от модели

Замените модель, перезапустите процесс или продолжите на следующей неделе. Следующий агент может получить ограниченный контекст проекта вместо того, чтобы восстанавливать старый чат.

Шлюзы выпуска, учитывающие доказательства

Решения, результаты, квитанции и переходы статусов становятся запрашиваемыми входными данными для CI, управления выпуском, разбора инцидентов и утверждения человеком.

Память с границами

Witness — это не безграничный дамп транскриптов. Публичное ядро хранит объявленные объекты проекта, редактирует поддерживаемые PII перед сохранением, использует ограниченные чтения и запрещает необъявленные полномочия.

Аудит-журнал, который агенты не могут легко переписать

Мутации публичного ядра и события аудита фиксируются вместе или не фиксируются вовсе. Канонические триггеры защищают историю операций, доступную только для добавления, от обновления и удаления.

Функции мечты

Это включённые паттерны, а не встроенная оркестрация в v0.1.0:

• Автономные фабрики ПО, где каждый выпуск может ответить, кто решил, кто построил, что было протестировано и какие доказательства прошли.

• Непрерывность между моделями, где Claude, GPT, локальные модели и специализированные агенты могут меняться местами, не теряя истину проекта.

• Самообучающиеся агентные организации, где проверенные результаты могут позже питать слой обучения, а не исчезать в истории чата.

• Понятная владельцу автономия, где человек может спросить «Почему система сделала это?» и получить записанную цепочку решений.

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

• Переносимое доказательство, где внешний валидатор может проверить выпущенные доказательства, не доверяя рассказу строителя.

Witness предоставляет субстрат доказательств. Планировщики агентов, порождение строителей, автоматическое обучение и межпродуктовые мосты — это отдельные слои.

Сделано сейчас — и ещё не сделано

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

Публичная поверхность MCP

Канонические контракты находятся в spec/. FTS5 — это локальный текстовый поиск, а не семантический или векторный поиск.

Установка и проверка

Требуется Python 3.11+ и uv.

./install.sh --manifest --json
./install.sh --target "$HOME/.local/share/witness" --non-interactive --json
uv sync --locked
uv run python -m pytest -q -p no:cacheprovider tests repair-tests
uv build

Поэтапный установщик очищает унаследованные переменные окружения Python, выполняет заблокированную установку, записывает ограниченную локальную конфигурацию/хранилище и запускает реальную MCP-проверку при первом запуске.

Центр проекта

• Дорожная карта продукта: ROADMAP.md

• Управление и полномочия выпуска: GOVERNANCE.md

• Вклад и DCO: CONTRIBUTING.md

• Сообщение о безопасности: SECURITY.md

• Границы поддержки: SUPPORT.md

• Официальные названия и форки: TRADEMARKS.md

Лицензия

Лицензировано под Apache License 2.0. См. NOTICE. Apache-2.0 разрешает использование, модификацию, распространение и коммерческое использование; он не даёт разрешения подразумевать официальный статус проекта или одобрение товарного знака.