Metadata-Version: 2.4
Name: velocus
Version: 0.3.0
Summary: Velarium ecosystem CLI — scaffold
Project-URL: Homepage, https://github.com/eddiethedean/velarium
Project-URL: Repository, https://github.com/eddiethedean/velarium
Project-URL: Documentation, https://github.com/eddiethedean/velarium/blob/main/docs/README.md
Project-URL: Changelog, https://github.com/eddiethedean/velarium/blob/main/CHANGELOG.md
Author: Velarium contributors
License: MIT
Keywords: cli,typing,velarium
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# velocus

**Role in Velarium:** **Ecosystem CLI** — single entry point to inspect IR, drive builds, and dispatch to backends (**velotype**, **morphra**, **granitus**, future tools) without each package exposing a separate UX.

| | |
|---|---|
| **PyPI** | `velocus` (scaffold) |
| **Status** | **Scaffold** — orchestration not implemented |

## Today

Use the [**velotype**](../velotype/README.md) CLI for:

- `velotype ir` — print ModelSpec JSON for a class the builders support (see [docs/model-sources.md](../../docs/model-sources.md))  
- `velotype stub` — emit `.pyi` body  

## Planned behavior

Thin orchestration only: parse commands, call **`velarium`** and backend packages, format output — no duplicated IR logic (see [docs/valarium.md](../../docs/valarium.md)).

## See also

- [docs/design.md](../../docs/design.md) — CLI philosophy  
- [docs/modelspec-ir.md](../../docs/modelspec-ir.md) — IR consumed by orchestrated tools  
- [Documentation index](../../docs/README.md)  
