Agent Residue Evidence

Agent Residue Evidence (ARE)는 에이전트의 테스트 및 빌드 워크플로우에 증거 체크포인트를 추가합니다:

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

ARE는 태스크 범위의 파일, 디렉토리, 귀인된 프로세스 및 해당 리스닝 포트를 표시합니다. 파일을 삭제하거나, 프로세스를 중지하거나, 포트를 닫거나, 무언가 삭제해도 안전하다고 판단하거나, 전체 머신을 스캔하거나, 데이터를 업로드하거나, 네트워크를 사용하거나, 텔레메트리를 수집하지 않습니다.

프로젝트 사이트를 방문하거나, 재현 가능한 태스크 잔여물 데모를 실행하거나, 최신 검증 릴리스를 다운로드하세요.

표준 태스크

첫 번째 테스트 또는 빌드를 시작하기 전에, 에이전트는 정확한 워크스페이스와 태스크가 소유한 임시 루트를 사용하여 begin_task_observation을 호출합니다. 이벤트는 선택 사항입니다. 안전한 일반 이벤트나 빈 하트비트는 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를 사용하면 다시 관찰하지 않고 저장된 보고서를 읽을 수 있습니다.

모든 관찰은 불투명한 소유자 권한에 의해 격리됩니다. 태스크 ID, 보고서 ID, 관찰 ID 및 후보 ID는 표시 참조일 뿐이며 액세스를 승인하지 않습니다. 상태는 불투명한 파일 이름으로 저장 시 암호화됩니다. 정확한 경로는 승인된 후보 해결 호출을 통해서만 공개됩니다. 수명이 짧은 실행자 권한은 명시적으로 허용된 이벤트 유형과 루트 별칭만 추가할 수 있으며, 태스크를 읽거나, 종료하거나, 검증하거나, 해결할 수 없습니다.

MCP 인터페이스에는 정확히 8개의 도구가 포함됩니다:

• begin_task_observation

• append_task_events

• end_task_observation

• inspect_completed_task

• get_residue_report

• verify_task_residue

• delegate_task_executor

• resolve_residue_candidate

의도적으로 cleanup, delete, execute, terminate, 또는 close 도구는 없습니다.

로컬 우선 패키징

하나의 릴리스에는 네이티브 CLI/stdio MCP 서버, 가벼운 Agent Plugin, MCPB, 체크섬, 출처, SPDX SBOM이 포함됩니다. 빠른 시작 및 설치를 참조하세요. 런타임 운영은 완전히 로컬 및 오프라인입니다. 보고서는 기본적으로 7일 보존과 총 100 MB 상한을 가지며, 보존된 보고서와 활성 베이스라인은 보호됩니다. 제거는 보고서를 조용히 삭제하지 않습니다.

MCP 레지스트리 네임스페이스는 io.github.fantasyce/agent-residue-evidence입니다.

네이티브 승인은 필수 네이티브 CI 작업을 통해 macOS 14+ arm64, Linux amd64, Windows 11 amd64를 포함합니다. 크로스 컴파일만으로는 네이티브 승인으로 보고되지 않습니다.

개발

Go 1.26 또는 1.27이 필요합니다.

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

Apache-2.0 라이선스입니다. 보안, 기여 및 네이티브 승인을 참조하세요.