odcs 0.9.1

Reference implementation of the Open Data Contract Standard (ODCS)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81

# Release status

Current tree version: **0.9.1** on `main`. Latest published: **0.9.0** (2026-07-03). **1.0.0** stabilization is complete on `main`, pending release tag and crates.io/PyPI publish.

## 1.0 release gate

| Item | Status |
|------|--------|
| Remove deprecated strict API | Complete |
| Public API audit + stability policy | Complete |
| Documentation sync | Complete |
| Registry path confinement | Complete |
| YAML limits documented | Complete |
| 0.9 → 1.0 migration guide | Complete |
| CHANGELOG + release notes for 1.0.0 | Pending |
| Crates.io + PyPI publish | Pending |

See [ROADMAP.md](../../ROADMAP.md) Phase 16 and [api-stability.md](../implementation/api-stability.md).

## Version alignment

| Source | Version | Status |
|--------|---------|--------|
| `Cargo.toml` | **0.9.1** | Aligned |
| `pyproject.toml` | **0.9.1** | Aligned |
| `CHANGELOG.md` | **0.9.1** | Release notes present |
| Git tag | **v0.9.1** | Pending |

## Registry status

| Registry | Latest published |
|----------|------------------|
| [crates.io](https://crates.io/crates/odcs) | **0.9.0** |
| [PyPI](https://pypi.org/project/pyodcs/) | **0.9.0** |

Release workflow: [actions/runs/28630711719](https://github.com/eddiethedean/odcs/actions/runs/28630711719) (success).

## Install 0.9.1

### From crates.io / PyPI (after release)

```bash
cargo install odcs --version 0.9.1 --locked
pip install pyodcs==0.9.1
```

### Install latest published (0.9.0)

```bash
cargo install odcs --version 0.9.0 --locked
pip install pyodcs==0.9.0
```

### From source

```bash
git clone https://github.com/eddiethedean/odcs.git
cd odcs
cargo install --path . --locked
maturin develop --features python --locked
```

## What changed in 0.9.1

See [Changelog](../changelog.md). Highlights:

- `pyodcs` CLI parity with `odcs` (`diff`, `registry`, cross-file validate flags)
- User guides for local registry and compatibility diff
- Doc version lint in CI checks

## What changed in 0.9.0

See [Changelog](../changelog.md). Highlights:

- Local contract registry: `odcs registry index|lookup|list`
- `odcs validate --registry <dir>` for registry-backed FQN resolution
- Python registry helpers and `parse_and_validate_paths(..., registry=...)`

## Previous release

**0.8.0** — Section semantics, cross-file references, and compatibility analysis.