# Conceptual Architecture

Cogna8 is structured as an authority runtime around governed state. It sits between agent intent and real-world side effects, with state verification, authorization decisions, and traceability across the path.

***

## Core Components

{% tabs %}
{% tab title="State Management" %}
**State Formation and Lifecycle**

The foundation. Responsible for identifying information that carries operational weight, structuring it as governed state items with type classification, canonical keying, and lifecycle management.
{% endtab %}

{% tab title="Conflict Detection" %}
**Integrity Evaluation**

Continuously evaluates new or changed state against active state in the applicable scope. Surfaces contradictions as structured records. Detects value conflicts, constraint conflicts, and precondition gaps.
{% endtab %}

{% tab title="Action Gating" %}
**Authorization Engine**

Evaluates whether a requested action has sufficient integrity and policy compliance to proceed. Returns **allow** / **warn** / **block** with structured reasons. Same state and policy produces the same result every time.
{% endtab %}

{% tab title="Trace and Audit" %}
**Reason Recorder**

Records state transitions, conflict events, gate evaluations, and policy check outcomes. Each entry is tied to specific state items and checks - not generic event logging.
{% endtab %}

{% tab title="Scope Management" %}
**Boundary Enforcer**

Determines which state is visible and governing for a given operation. Enforces scope boundaries (thread / entity / global) with configurable inheritance. Surfaces scope violations as integrity events.
{% endtab %}
{% endtabs %}

***

## How They Connect

{% stepper %}
{% step %}
**Input arrives**

Conversation, event, or API call enters the system
{% endstep %}

{% step %}
**State Management processes it**

Extract, classify, normalize, key, assign lifecycle status
{% endstep %}

{% step %}
**Conflict Detection evaluates integrity**

Compare against active state in the resolved scope
{% endstep %}

{% step %}
**Policy + Action Gating decides**

Allow, warn, or block - with structured reasons
{% endstep %}

{% step %}
**Trace Engine records everything**

State changes, conflicts, gate decisions, and their reasons
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**This modular design is intentional.** Each component has a defined responsibility. Cogna8 complements existing memory, orchestration, and UI layers rather than replacing them.
{% 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/architecture/conceptual-architecture.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.