Metadata-Version: 2.4
Name: ariadne-data
Version: 0.6.0
Summary: Governed metrics for autonomous agents: OKF context layer + OSI semantic layer behind one MCP facade
Requires-Python: >=3.14
Description-Content-Type: text/markdown
Requires-Dist: duckdb>=1.0
Requires-Dist: sqlglot>=25.0
Requires-Dist: openai>=1.40
Requires-Dist: pyyaml>=6.0
Requires-Dist: jsonschema>=4.18
Provides-Extra: mcp
Requires-Dist: mcp==2.2.0; extra == "mcp"
Provides-Extra: documents
Requires-Dist: liteparse>=2.4.0; extra == "documents"
Requires-Dist: markitdown[docx]>=0.1.6; extra == "documents"
Requires-Dist: firecrawl-anydoc==0.1.3; extra == "documents"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"
Requires-Dist: mcp==2.2.0; extra == "dev"
Requires-Dist: liteparse>=2.4.0; extra == "dev"
Requires-Dist: markitdown[docx]>=0.1.6; extra == "dev"
Requires-Dist: firecrawl-anydoc==0.1.3; extra == "dev"

# Ariadne

**Governed metrics for AI agents.** Ariadne gives agents a reviewed source of truth for business metrics: definitions are compiled and queried by Ariadne, while business policies and caveats travel with the answer.

Raw text-to-SQL asks an agent to guess tables, joins, filters, and definitions. Ariadne separates those responsibilities into two layers:

- **Semantic Layer (OSI):** reviewed metric definitions, compiled to SQL and executed read-only by Ariadne.
- **Context Layer (OKF):** business policies, source caveats, and terminology that explain how to interpret a result.

Ariadne is a Python package with embedded DuckDB. Use it locally through the CLI, connect an agent through optional MCP, or add the separately distributed Ariadne Agent. A human remains responsible for source approval and for admitting the exact reviewed Git revision. Ariadne is not a BI dashboard or a high-concurrency metrics API.

## Documentation

The documentation follows [Diátaxis](https://diataxis.fr/):

- **[Tutorial](docs/tutorials/getting-started.md):** create a project and reach a first governed query.
- **[How-to guides](docs/README.md#how-to-guides):** complete specific tasks such as Git-backed authoring, private Docker MCP setup, or reading multiple S3 storages.
- **[Reference](docs/README.md#reference):** look up CLI commands, data-source configuration, and migration mappings.
- **[Explanation](docs/explanations/how-ariadne-works.md):** understand Ariadne's layers, governance gates, and authority boundaries.

The [documentation index](docs/README.md) lists all guides and references for **Ariadne 0.6.0**.

**Data Contracts:** the [reference](docs/reference/data-contracts.md) describes
Core’s limited, pinned ODCS v3.2.0 consumer profile, separate Git bindings and
as-of evidence. Source-free `ariadne search` includes a contracts group;
`list-datasets` remains an approved live-catalog operation. This is not full
ODCS compliance, a live health guarantee, or shared cross-layer identity (#76).

**Lumio integration:** [Lumio bound releases](docs/reference/lumio-bound-releases.md)
describe the optional integrated context binding: one shared Content Commit, an
operator-confirmed overall admission activating a local immutable Bound Release,
strict `metric`/`policy`/`reference` profiles, full required Policy context on governed
answers, and source-free navigation over the pinned published pages. Git is the
standard transport and sync never activates a release — `ariadne status`
reports the local Git HEAD separately from the admitted release (see
[the local Git how-to](docs/how-to/lumio-git-local.md)); the SDK stays an optional
dependency, unsupported integrated operations refuse, and exact build pairing is
recorded per release rather than assumed from package versions.

## Source development

Work on Ariadne itself happens from the package checkout, not inside a data project:

```bash
uv venv --python 3.14 .venv
uv pip install --python .venv/bin/python -e .
source .venv/bin/activate
# Optional MCP example (after creating and admitting a project; requires .[mcp]):
uv pip install --python .venv/bin/python -e '.[mcp]'
examples/retail-demo/mcp_client.py --project /path/to/admitted/retail-project
```

For a candidate-wheel check, run `uv build`, install `dist/ariadne_data-*.whl`
into a fresh virtual environment, and follow the [getting-started tutorial](docs/tutorials/getting-started.md)
with the installed console scripts rather than the editable install.
