# Audit Trail

Cogna8 records governance events in an append-only audit trail so teams can inspect how the system moved from input to state to action outcome. This is one of the core reasons the product is useful beyond a memory layer - it preserves decision accountability.

***

## What the Audit Trail Supports

The audit trail answers questions like: Why did this state change? Why was this action blocked? Which conflict was resolved and how? What policy rule caused the decision? What evidence was used at the time?

In operational AI, these are not edge cases. They are normal workflow questions.

***

## What Gets Recorded

{% tabs %}
{% tab title="State Events" %}
Lifecycle transitions - creation, confirmation, supersession, expiry, and all status changes.
{% endtab %}

{% tab title="Conflict Events" %}
Detection, resolution choices, and their outcomes.
{% endtab %}

{% tab title="Gate Events" %}
Evaluations, decisions (allow/warn/block), and the structured reasons behind each.
{% endtab %}

{% tab title="Policy Events" %}
Policy changes and policy-related evaluation outcomes.
{% endtab %}
{% endtabs %}

{% hint style="info" %}
**Cogna8 supports compliance-oriented and audit-friendly workflows through traceability.** The value is that it creates the evidentiary and operational structure teams need to govern actions and investigate outcomes.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cogna8-io.gitbook.io/docs/core-concepts/audit-trail.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.