Skip to content
Change Guards
Menu

Take an evidence export

Produce a verified record of the governance trail for an auditor, and know what it does and does not prove.

Agent About 3 minutes Step 6 of 6

An evidence export is the governance record — the changes, who approved them, and the audit chain — with a verification result computed at the moment you take it.

Taking one

  1. 1

    Open Evidence

    In your project sidebar. Every agent can take an export; doing so is itself recorded on the chain.

  2. 2

    Choose a scope

    Whole project for an audit or a period review. One change when somebody is asking about a specific incident — enter its issue key.

  3. 3

    Choose a format

    JSON is lossless and re-verifies offline. CSV opens in a spreadsheet for filtering.

  4. 4

    Take the export

    The chain is recomputed from genesis, and the result is written into the export itself.

  5. 5

    Copy it out

    Select the export and save it under the filename shown.

The evidence page showing scope and format choices, a green verified-chain lozenge, counts of changes, approvals and audit entries, and the start of the JSON export.
The verification block is the first thing in the file, not a footnote.

What is in it

Reading the verification block

Every export carries a plain-English statement. An intact chain reads roughly:

The project-wide audit chain was re-verified at export time: 51 entries recomputed from genesis, every hash and linkage intact.

A broken one says so, in the file as well as on the screen, and tells you not to rely on the export:

The project-wide audit chain FAILED verification at export time at entry 34. 33 entries verified before the failure. This export must not be relied upon as evidence.

What it proves, and what it does not

It proves that the changes, approvals and trail are exactly as recorded, and that no entry has been altered, re-pointed or removed since it was written.

It does not prove that what was recorded was true. If somebody records a change inaccurately, the chain faithfully preserves the inaccuracy. Tamper-evidence is a guarantee about the record, not about the honesty of whoever typed it.

If verification fails

  1. Do not delete anything. Deleting entries makes it worse and is itself detectable.
  2. Keep the failed export. It captures the state and the verdict at that moment.
  3. Note the entry number. The verdict names where the chain first diverged.
  4. Raise it. A broken chain is a material fact about evidence you may already have relied on.

Before you uninstall

Take a project-scoped export for every project under governance. Uninstalling removes the app’s storage from your site, and the export is the only portable, self-verifying copy of what it held.