# Cognoxium

**Pandas for trustworthy AI context.**

Cognoxium is a local-first Rust and Python library that turns messages, retrieved documents, and tool results into typed, provenance-aware context. It selects a deterministic context pack under a token budget and records every exclusion, merge, truncation, and policy decision.

Cognoxium sits between application inputs and a model SDK:

```text
retriever / tools / messages
            |
            v
      CognitionFrame
  filter -> dedupe -> rank
            |
            v
  policy + budget -> ContextPack + PackManifest
            |
            v
    provider renderer -> model SDK
```

It does not retrieve documents, call a model, authorize tool actions, transmit data, or require an account.

## Where should I start?

- New to Cognoxium: follow {doc}`quickstart`.
- Coming from pandas: read {doc}`pandas-users`.
- Integrating external data: read {doc}`building`, then {doc}`boundaries`.
- Handling a model limit: read {doc}`packing` and {doc}`overflow`.
- Evaluating security claims: read {doc}`security` and {doc}`roadmap`.
- Looking up a symbol: use {doc}`api`.

```{toctree}
:maxdepth: 2
:caption: Learn

installation
quickstart
pandas-users
concepts
building
filtering-ranking-dedupe
packing
overflow
boundaries
lineage
rendering
security
plugins
performance
recipes
troubleshooting
glossary
roadmap
```

```{toctree}
:maxdepth: 2
:caption: Reference and development

api
rust-api
migration
changelog
contributing
architecture
```

```{toctree}
:hidden:

operations
```

## Stability

Cognoxium 0.1.1 is alpha software. Public diagnostic codes are stable within a minor release, while serialized schemas may change before 1.0 with a documented migration path. The {doc}`roadmap` distinguishes implemented behavior from non-binding future directions.