Metadata-Version: 2.4
Name: tiksi
Version: 0.1.0
Summary: Foundation — shared epistemic primitives for Yanantin, Willay, and Pukara
Requires-Python: >=3.14
Requires-Dist: pydantic>=2.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == 'dev'
Description-Content-Type: text/markdown

# Tiksi

Tiksi is Quechua for *foundation, origin, primal cause*. This package
holds the shared epistemic primitives that Yanantin, Willay, and Pukara
all rest on:

- a frozen Pydantic base model;
- declared losses and epistemic metadata (T/I/F);
- provenance envelopes and source identifiers;
- tensor, strand, and key-claim records;
- composition edges, corrections, dissent, negation, bootstrap, schema evolution;
- entity resolution.

The whole package is pure Pydantic. It has no database, no HTTP, no
attestation. Depending on Tiksi does not drag in storage backends or
service runtimes — that is the point.

## Install

```bash
uv add tiksi
```

## Use

```python
from tiksi import EpistemicMetadata, TensorRecord, ProvenanceEnvelope

t = TensorRecord(narrative_body="hello")
```

## Where this fits

- **Yanantin** stores and retrieves anchored memory. It uses Tiksi models.
- **Willay** issues and verifies attestation receipts. It uses Tiksi models.
- **Pukara** is a storage-confidentiality gateway. It uses Tiksi models.

Tiksi is the small, stable layer they share. Changing Tiksi changes
all three; that is the cost of the abstraction and the reason it
stays small.
