openclaw/reporting-governance-plugin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: define reporting governance adapter interface

Browse Source
This commit is contained in:
Eve
2026-05-07 22:37:43 +08:00
parent 6584bc16a8
commit 6b04aa3b74
3 changed files with 1116 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
docs/architecture/agent-reporting-governance-plugin.md
View File

@@ -150,6 +150,40 @@ The design stance is:
- **explicit labels over ambiguous proxy language**
- **governed completion over self-declared completion**
## Current architecture trajectory
The product definition is now backed by a concrete runtime-integration direction:
- canonical governance contracts are defined in the event, evidence, decision, and policy-pack specs
- runtime portability is carried by an explicit adapter interface
- the completed watchdog auto-notify chain is treated as the first reference adapter composition rather than as standalone repair glue
In practice, the current reference composition is:
```text
watchdog runner
-> canonical event
-> operator notification queue
-> dispatcher spool handoff
-> bridge supervisor
-> sender binding
-> acked | blocked | pending_external_send receipt
```
This matters architecturally because it proves the plugin can:
- turn elapsed-time governance failure into canonical machine-readable events
- route required operator-visible follow-up across runtime boundaries
- preserve honest delivery semantics instead of collapsing `dispatched` into false success
- provide a migration path from repo scripts toward package-level adapters and deployment profiles
The mainline next step is therefore not “more watchdog patching,” but formalizing this runtime composition inside the plugin’s adapter and capability model so future package extraction has a stable target.
Primary follow-on specs:
- `docs/specs/reporting-governance-adapter-interface.md`
- `schemas/reporting-governance/adapter-capabilities.schema.json`
## Summary
The Agent Reporting Governance Plugin is a portable enforcement layer for trustworthy agent reporting. It exists because prompts alone cannot reliably prevent missing reports, late reports, fake progress, skipped checkpoints, unverified completion claims, dropped subagent results, or mislabeled placeholder/proxy reporting.