Agent Residue Evidence

Agent Residue Evidence (ARE) fügt dem Test- und Build-Workflow eines Agenten einen Evidenz-Checkpoint hinzu:

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

ARE zeigt auf den Task begrenzte Dateien, Verzeichnisse, zugeordnete Prozesse und deren lauschende Ports an. Es löscht niemals Dateien, beendet keine Prozesse, schließt keine Ports, entscheidet nicht, dass etwas sicher gelöscht werden kann, scannt nicht den gesamten Rechner, lädt keine Daten hoch, nutzt nicht das Netzwerk und sammelt keine Telemetrie.

Besuchen Sie die Projektwebsite, führen Sie die reproduzierbare Task-Residue-Demo aus oder laden Sie das neueste verifizierte Release herunter.

Standard-Task

Vor dem ersten Test oder Build ruft der Agent begin_task_observation mit dem exakten Workspace und allen Task-eigenen temporären Wurzelverzeichnissen auf. Ereignisse sind optional; unbedenkliche generische Ereignisse oder leere Heartbeats können mit append_task_events gesendet werden. Vor seiner endgültigen Antwort ruft der Agent end_task_observation auf, erläutert die Kandidaten und fragt den Benutzer, was er tun soll. Erst nach ausdrücklicher Genehmigung bereinigt der Agent mit seinen normalen Tools. Anschließend ruft er verify_task_residue auf, um dieselben stabilen Kandidaten erneut zu prüfen.

NO_CANDIDATES_OBSERVED bedeutet nur, dass kein Kandidat innerhalb des deklarierten Beobachtungsbereichs aufgetreten ist. Es ist keine hostweite Sauberkeitsaussage.

Related MCP server: SystemLens

Abgeschlossener Task ohne Baseline

inspect_completed_task akzeptiert explizit angegebene Wurzelverzeichnisse und ein begrenztes Zeitfenster. Das Ergebnis ist immer PARTIAL_EVIDENCE; es kann Event-Evidenz, Beleg-Evidenz, abgeleitete oder nicht zugeordnete Evidenz verwenden, gibt jedoch niemals BASELINE_OBSERVED an. Verwenden Sie get_residue_report, um einen gespeicherten Bericht zu lesen, ohne erneut zu beobachten.

Jede Beobachtung ist durch eine undurchsichtige Owner-Capability isoliert. Task-IDs, Berichts-IDs, Beobachtungs-IDs und Kandidaten-IDs sind nur Anzeige-Referenzen und autorisieren niemals Zugriff. Der Zustand wird im Ruhezustand mit undurchsichtigen Dateinamen verschlüsselt; genaue Pfade werden nur durch einen autorisierten Aufruf zur Kandidatenauflösung offengelegt. Kurzlebige Executor-Capabilities können nur explizit erlaubte Ereignistypen und Root-Aliase anhängen und können einen Task weder lesen, beenden, verifizieren noch auflösen.

Die MCP-Oberfläche umfasst genau acht Tools:

• begin_task_observation

• append_task_events

• end_task_observation

• inspect_completed_task

• get_residue_report

• verify_task_residue

• delegate_task_executor

• resolve_residue_candidate

Es gibt kein Tool zum Bereinigen, Löschen, Ausführen, Beenden oder Schließen.

Local-First-Paketierung

Ein Release enthält einen nativen CLI/stdio-MCP-Server, ein schlankes Agent-Plugin, MCPB, Prüfsummen, Provenienz und SPDX SBOM. Siehe Quickstart und Install. Der Laufzeitbetrieb ist vollständig lokal und offline. Berichte haben standardmäßig eine Aufbewahrungsfrist von sieben Tagen und ein Gesamtlimit von 100 MB; aufbewahrte Berichte und aktive Baselines sind geschützt. Die Deinstallation löscht Berichte niemals stillschweigend.

Der Namespace der MCP Registry ist io.github.fantasyce/agent-residue-evidence.

Die native Akzeptanz deckt macOS 14+ arm64, Linux amd64 und Windows 11 amd64 durch obligatorische native CI-Jobs ab. Alleinige Kreuzkompilierung wird nicht als native Akzeptanz ausgewiesen.

Entwicklung

Go 1.26 oder 1.27 ist erforderlich.

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

Lizenziert unter Apache-2.0. Siehe Security, Contributing und native Akzeptanz.