velocus 0.5.0

Velarium ecosystem CLI — scaffold

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	pypi.org/project/velocus (scaffold)
Repository	github.com/eddiethedean/velarium
Python	3.10+ (when implemented)
Status	Scaffold — orchestration not implemented

Today

Use the velotype CLI on PyPI for:

• velotype ir — print ModelSpec JSON for a class the builders support (see docs/model-sources.md)
• velotype stub — emit .pyi body
• velotype batch stub / velotype batch ir — package-wide dataclass discovery and merged outputs (see docs/tutorial-stubs.md)

Stub behavior and CI validation are documented in docs/stub-compatibility.md.

Planned behavior

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

See also

• docs/design.md — CLI philosophy
• docs/modelspec-ir.md — IR consumed by orchestrated tools
• Roadmap
• Repository README
• Documentation index
• velotype on PyPI — use this for stubs and IR export today

License

MIT — see LICENSE.