Agent Residue Evidence

Agent Residue Evidence (ARE) добавляет контрольную точку сбора доказательств в рабочий процесс тестирования и сборки агента:

observe → Agent reviews evidence → user authorizes cleanup
        → Agent cleans with its own tools → ARE verifies

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

Посетите сайт проекта, запустите воспроизводимую демонстрацию остаточных артефактов задачи или скачайте последний проверенный релиз.

Стандартная задача

Перед первым тестом или сборкой агент вызывает begin_task_observation с точным рабочим каталогом и любыми временными корневыми каталогами, принадлежащими задаче. События необязательны; безопасные стандартные события или пустые heartbeat-события можно отправлять через append_task_events. Перед финальным ответом агент вызывает end_task_observation, объясняет кандидатов и спрашивает пользователя, что делать. Только после явного разрешения агент выполняет очистку своими обычными инструментами. Затем он вызывает verify_task_residue, чтобы повторно проверить те же стабильные кандидаты.

NO_CANDIDATES_OBSERVED означает лишь то, что ни один кандидат не появился в объявленной области наблюдения. Это не утверждение о чистоте всего хоста.

Related MCP server: SystemLens

Завершённая задача без базовой линии

inspect_completed_task принимает явно указанные корневые каталоги и ограниченное временное окно. Результат всегда PARTIAL_EVIDENCE; он может использовать событийные, подтверждающие, выводные или неприписанные доказательства, но никогда не заявляет BASELINE_OBSERVED. Используйте get_residue_report, чтобы прочитать сохранённый отчёт без повторного наблюдения.

Каждое наблюдение изолировано непрозрачной capability владельца. Идентификаторы задач, отчётов, наблюдений и кандидатов — это только отображаемые ссылки, и они никогда не дают доступ. Состояние зашифровано при хранении, имена файлов непрозрачны; точные пути раскрываются только через авторизованный вызов для разрешения кандидата. Недолговечные capabilities исполнителя могут добавлять только явно разрешённые типы событий и псевдонимы корней и не могут читать, завершать, проверять или разрешать задачу.

Поверхность MCP содержит ровно восемь инструментов:

• begin_task_observation

• append_task_events

• end_task_observation

• inspect_completed_task

• get_residue_report

• verify_task_residue

• delegate_task_executor

• resolve_residue_candidate

Здесь намеренно нет инструментов очистки, удаления, выполнения, завершения или закрытия.

Локально-ориентированная упаковка

Один релиз содержит нативный MCP-сервер CLI/stdio, тонкий Agent Plugin, MCPB, контрольные суммы, сведения о происхождении и SPDX SBOM. См. Краткое руководство и Установку. Работа в рантайме полностью локальна и офлайн. Для отчётов по умолчанию действует хранение в течение семи дней и общий лимит 100 MB; сохранённые отчёты и активные базовые линии защищены. Деинсталляция никогда не удаляет отчёты молча.

Пространство имён MCP Registry: io.github.fantasyce/agent-residue-evidence.

Нативное подтверждение охватывает macOS 14+ arm64, Linux amd64 и Windows 11 amd64 через обязательные нативные задания CI. Одна только кросс-компиляция не считается нативным подтверждением.

Разработка

Требуется Go 1.26 или 1.27.

bash scripts/check.sh
bash scripts/run_native_acceptance.sh

Лицензия Apache-2.0. См. Безопасность, Участие в разработке и нативное подтверждение.