stella db - Command Guide

The stella db command group triggers Concelier database operations via backend jobs (connector stages, merge reconciliation, exports).

These commands are operational: they typically require Authority authentication and appropriate Concelier scopes.

Commands

Trigger a connector stage (fetch, parse, or map) for a given source.

stella db fetch --source osv --stage fetch
stella db fetch --source osv --stage parse
stella db fetch --source osv --stage map

Options:

--source (required): connector identifier (for example osv, redhat, ghsa).
--stage (optional): fetch, parse, or map (defaults to fetch).
--mode (optional): connector-specific mode (for example init, resume, cursor).

Run canonical merge reconciliation.

stella db merge

Run Concelier export jobs.

stella db export --format json
stella db export --format trivy-db --delta

Options:

--format (optional): json or trivy-db (defaults to json).
--delta (optional): request a delta export when supported.
--publish-full / --publish-delta (optional): override whether exports are published (true/false).
--bundle-full / --bundle-delta (optional): override whether offline bundles include full/delta exports (true/false).

Point the CLI at the Concelier base URL:

export STELLAOPS_BACKEND_URL="https://concelier.example.internal"

Authenticate:

stella auth login

See: docs/10_CONCELIER_CLI_QUICKSTART.md and docs/modules/concelier/operations/authority-audit-runbook.md.