Appearance
Audit evidence
An auditor asks two questions about agents:
- Is the population complete?
- Can a sample be traced from the grant to every action?
DutyGraph answers both for the agents it governs. It does not yet answer the first for every agent in the enterprise.
Two populations
| Population | What it is | Status |
|---|---|---|
| Governed population | Every agent requested through DutyGraph, as recorded in DutyGraph | Built |
| Reconciled enterprise population | Every agent and non-human identity in the company's own systems, matched to DutyGraph's records | Planned |
The register: the governed population
The register lists every agent requested through DutyGraph, with its owner, requester, systems, status and expiry. Agents saved in the builder but never requested show as "Drafted, not requested". Expired, revoked and suspended agents stay in the count.
The register is complete only for agents requested through DutyGraph. An agent someone built and connected without DutyGraph is not in it.
Found outside DutyGraph: sample data
In the illustrative distributor sample, the register also lists non-human identities "found outside DutyGraph". These identities are illustrative sample data. DutyGraph did not discover them in a live system. For a real company, this list is empty until reconciliation is built.
Reconciliation: the enterprise population
INFO
Planned. The reconciliation process is written down, not built.
- Import or query agent and identity inventories from authorized sources.
- Normalize the identities.
- Match them to governed agents.
- Flag agents found outside DutyGraph.
- Flag approved agents missing from the external systems.
- Flag differences between approved and actual entitlements.
- Record each finding and its remediation.
The trace
From any agent, the auditor can open the trace: owner → Task Card → scopes → rules → each decision → issue → each call through the gateway.
The trace shows what was recorded. It shows the Task Card the request named. It does not show proof that the Task Card needed each scope, because that check (CEIL-02) is not enforced. See The key join.
Lifecycle evidence
The ledger records issue, event end and revocation. The gateway blocks calls after an agent's end date.
The lifecycle is not automatic when an owner leaves. Marking a person as left does not suspend or revoke their agents. Revoke them by hand. Automatic suspension is Planned.
The export
Export one agent or a filtered population as CSV or JSON. The planned full packet is one zip:
| File | Contents |
|---|---|
agents.csv | One row per agent: owner, requester, systems, status, request and approval ids |
permissions.csv | One row per agent and scope: final state, reason, rule id@version, control, and whether the owner held the scope on the decision date |
decisions.csv | One row per decision: step, decider and role, decision, change, rules, time, record hash |
activity.csv | One row per gateway call: tool, scope, allowed or blocked, rule. Arguments are omitted. |
lifecycle.csv | Issue, event end and revocation entries from the ledger |
population.csv | Each governed agent, plus any identity listed as found outside DutyGraph |
ledger.json | The ledger slice, the entry before it and the hashing rules |
README.txt | The filter, the counts and what the export does not cover |
Rules for evidence
- Point in time. Each row shows names and roles as recorded at the decision.
- No secrets and no business data. No credentials, no call arguments, no records from business systems.
- Honest coverage. The activity log covers calls through the DutyGraph gateway only.
- Integrity, not truth. Verify chain shows that the recorded entries were not changed. It does not show that the business claims in them are true.
INFO
Status. Built: the register of the governed population, the trace, Verify chain, and CSV and JSON export. Simulated: the "found outside DutyGraph" identities, which are illustrative sample data. Planned: reconciliation with the enterprise population, automatic lifecycle on owner departure, and the full zip packet with a standalone verifier script.
Source: gitbook/product/governance/audit-evidence.md in the DutyGraph repository.