Metadata-Version: 2.4
Name: traverse-annotations
Version: 0.2.0
Summary: Annotation stubs — no-op decorator for @traverse.realises. The Traverse platform reads annotation payloads via static AST parsing; this package exists for runtime copy-paste portability of polyglot design block snippets.
Project-URL: Homepage, https://trvrse.me
Project-URL: Repository, https://github.com/calmseas/traverse
Author: Traverse
License: Apache-2.0
License-File: LICENSE
Keywords: annotations,decorators,stub,traverse
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# traverse-annotations

WS-18 Phase 4 annotation stubs for Python.

Identity no-op decorators for `@traverse.realises(...)` and
`@traverse.conforms(...)`. Traverse reads annotation payloads via static AST
analysis (the polyglot parser at design promote-to-current time; `code_sync`
via codemap when indexing real source); this package exists so that
copy-pasted snippets execute in target codebases.

## Install

```sh
pip install traverse-annotations
```

## Usage

```python
import traverse_annotations as traverse

@traverse.realises(
    target="theory:theoremdecl:abc123",
    realisation_kind="partial",
    prefix_scope="Foo.Bar",
)
def my_function():
    ...

@traverse.realises("theory:theoremdecl:abc123", realisation_kind="partial")
def my_other_function():
    ...

# Bind a conformance test (pytest) to the obligation it certifies:
@traverse.conforms(obligation="engram-substrate/Verdict")
def test_verdict_conforms():
    ...
```

The decorators accept any payload shape — Traverse validates statically.

## Build

```sh
uv build
# or:
python -m build
```

## License

Apache-2.0. Copyright © 2026 Traverse.
