Witness Evidence

Открытый уровень доказательств для агентных систем

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

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

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

Witness Evidence предназначен для инженеров агентных платформ и ИИ-инфраструктуры, чьи агенты, модели и трассы растут быстрее, чем их способность сохранять принятое состояние проекта. Он записывает решения, привязанные к идентичности, прикреплённые доказательства, результаты, изменения жизненного цикла и ограниченный контекст проекта через MCP.

Делегируйте выполнение, не делегируя истину.

Запустите реальную локальную демонстрацию ядра v0.1.0 · Посмотрите, что работает сегодня · Изучите дорожную карту возможностей · Проверьте статус доказательств

Related MCP server: Clockchain Developer Tools MCP Server

Где вписывается Witness

MCP connects agents to tools.
A2A connects agents to agents.
Traces show what ran.
Durable runtimes keep workflows alive.
Witness preserves what was decided, which evidence was attached, which status transitions followed, and what the next agent may inherit.

Witness не заменяет среды выполнения агентов, трассировку, оркестрацию, Git или наблюдаемость. Он находится над деталями выполнения как устойчивая граница доказательств: место, где команда записывает решение, на которое она опиралась, полученный результат, ссылку на доказательство, идентичность, выполнившую каждый переход статуса, и контекст, который более поздний агент может восстановить.

Модель отказа

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

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.

Устойчивым объектом должен быть не разговор. Это должно быть засвидетельствованное состояние проекта.

Работает сегодня

Версия 0.1.0 выполняет локальное ядро доказательств с открытым исходным кодом:

• 10 инструментов MCP для проектов, решений, инсайтов, результатов, записей, жизненного цикла, ограниченного контекста и поиска FTS5;

• подписанные конверты идентичности агентов, привязанные к точному инструменту, полезной нагрузке запроса, тенанту, профилю, поколению среды выполнения и nonce;

• доступ на основе ролей с запретом по умолчанию и идемпотентные мутации;

• редактирование конфиденциальных данных перед сохранением;

• SQLite-хранилище с транзакционным аудитом операций только на добавление;

• реальный локальный поток с отдельными идентичностями исполнителя и валидатора;

• воспроизводимые артефакты релиза Apache-2.0 и поэтапная диагностика свежей установки.

Во включённой демонстрации отдельная синтетическая идентичность валидатора переводит результат в статус verified. Переход записывает этого участника и его причину. Версия 0.1.0 не обеспечивает разделение исполнителя/валидатора, не раскрывает ссылку на доказательство based_on результата через публичную проекцию чтения, не загружает указанный артефакт и не принимает решение о корректности автоматически. Это не автоматическая проверка доказательств.

Посмотрите, как система движется

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 reference
    Validator->>Witness: Read decision and outcome
    Validator->>Witness: Accept or dispute the result
    NextAgent->>Witness: Restore bounded project context
    Witness-->>NextAgent: Decision + outcome + acceptance state

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

[1/3] Decision recorded: require independent validation
[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

Ожидаемая финальная строка:

WITNESS_DEMO_PASS decisions=1 outcomes=1 outcome_status=verified distinct_validator=true context_restored=true

Что это даёт

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

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

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

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

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

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

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

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

Аудит, который обычные продуктовые вызовы не могут легко переписать

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

Что строим дальше

Межмодельная непрерывность проекта

Следующая возможность для разработчиков — переносимый контракт непрерывности: Claude, Codex, GPT, локальные модели и специализированные агенты должны иметь возможность использовать одно и то же ограниченное состояние проекта Witness и продолжать работу без доступа к исходному чату.

Это запланировано, но ещё не доказано извне. Доказательство требует, чтобы другая команда агентов восстановила текущее решение, прикреплённые доказательства и состояние приёмки; время восстановления и случаи отказа должны быть измерены. См. EVIDENCE.md.

В v0.1.0 не поставляются собственные адаптеры для Claude, Codex, OpenAI Agents SDK, LangGraph или Temporal. Сегодня эти системы могут получить доступ к Witness только через пользовательскую настройку MCP/клиента, выполненную интегратором. Документированные эталонные адаптеры — это работа по дорожной карте, а не текущая функциональность.

Северная звезда

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

Эта северная звезда включает переносимую проверку и возврат проверенного обучения: принятые результаты могут информировать последующую работу, не позволяя непроверенному тексту молча становиться политикой. Это не автоматическое межмодельное обучение в v0.1.0.

Архитектура из двух продуктов

Mission — отдельный продукт. Spindle — запланированная функция обучения внутри Witness.

Mission координирует работу агентов. Witness сохраняет доказательства и спроектирован для накопления проверенного обучения.

flowchart LR
    H["Human<br/>goal and direction"] --> M["Mission<br/>coordinates"]
    M --> G["Specialist agents<br/>work"]
    G --> E

    subgraph W["Witness"]
        E["Decision · Outcome · Evidence"] --> S["Spindle<br/>planned learning function"]
        S --> L["Patterns · Rules · Guards"]
    end

    L -. "future governed return" .-> M

Ядро доказательств работает сегодня. Полный цикл обучения Spindle запланирован. Его будущая задача внутри Witness — принимать результаты со статусом verified в жизненном цикле Witness и, после дополнительных критериев приемлемости и этапов проверки, превращать их в управляемые кандидаты на обучение, переиспользуемые шаблоны, правила и ограничения для последующих запусков Mission. Статус записывает переход приёмки; сам по себе он не доказывает, что Witness загрузил или независимо проверил лежащие в основе доказательства. Версия 0.1.0 не создаёт эти артефакты и не возвращает их автоматически.

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

Это поддерживаемые шаблоны, а не встроенная оркестрация сегодня:

• межмодельная непрерывность без доступа к транскрипту;

• переносимое доказательство, которое внешний валидатор может проверить, не доверяя повествованию исполнителя;

• возврат проверенного обучения через Spindle, запланированную внутреннюю функцию обучения Witness;

• понятная владельцу автономия с устойчивой цепочкой решений;

• память инцидентов, которая переносит принятую корневую причину и предотвращение в последующие миссии.

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

Mission и Witness — два основных продукта. Mission координирует работу; Witness владеет границей доказательств и запланированной функцией обучения Spindle. В v0.1.0 не поставляется автоматический возврат обучения от Witness к Mission.

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

Сервис не развёрнут этим репозиторием. Публикация и зелёный CI не доказывают производственную эксплуатацию, масштаб, экономию или влияние на пользователей.

Публичная поверхность 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.

Наименование и техническая идентичность

Witness Evidence — это публичный квалификатор; технические идентификаторы остаются неизменными. Репозиторий MaximilianoColoma/witness, пакет witness-public, Python-модуль witness_public, имена инструментов MCP, контракты и выпущенные артефакты v0.1.0 сохраняют свои существующие технические идентификаторы. Короче: история яснее; провод остаётся на месте.

Несвязанный устоявшийся проект также использует имя Witness. См. TRADEMARKS.md для уведомления о предотвращении путаницы.

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

• Дорожная карта возможностей: ROADMAP.md

• Статус доказательств и проверок: EVIDENCE.md

• Управление и полномочия релиза: GOVERNANCE.md

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

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

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

• Наименование и предотвращение путаницы: TRADEMARKS.md

Лицензия

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