# vona-cli-set-api

This package contains the authoritative Vona command catalog for backend-oriented CLI workflows.

## Source of truth

The top-level command-family registry lives in:

- `src/lib/commands.ts`

Inspect this file first when you need to answer:

- which Vona command families exist
- which command names are registered
- which command module implements each entry

Current families include:

- `default`
- `bin`
- `create`
- `init`
- `tools`

## Command metadata surface

Each command module under `src/lib/command/` provides the main CLI-facing metadata for that command, typically including:

- `bean`
- `info.title`
- `info.usage`
- `options`

Representative example:

- `src/lib/command/bin.play.ts`

## Recommended navigation path

1. run `npm run vona`
2. inspect `../cli/src/bin/vona.ts` for entry dispatch only
3. inspect `src/lib/commands.ts` for the authoritative family map
4. inspect the specific command module for usage and options

## Public reference

For the compact top-level overview shared across Vona and Zova, see:

- `../../../repo-docs/reference/cli-reference.md`