Skip to content

CLI

CELLAS conformance CLI — verify, certify, and related commands.

Overview

The cellas binary comes from @cellas/conformance-cli (installed by create-cellas). It is the primary operator surface for Conformance and Engine namespaces.

Concepts

NamespaceRole
verify / certify / test / …Conformance (@cellas/testing-cli)
engineEngine CLI (@cellas/engine-cli)
pluginPlugin tooling (@cellas/cli)

Exit codes (0–8)

CodeMeaning
0Success
1Mandatory test failure
2Usage or schema error
3Compatibility failure
4Security or authorization failure
5Integrity digest or signature failure
6Target or adapter unavailable
7Platform error
8Certification incomplete or not certified

Add --json for machine-readable output.

Example

pnpm exec cellas verify
pnpm exec cellas certify

Defaults come from cellas.config.yaml. Explicit recovery:

pnpm exec cellas verify --input examples/execution-record.json --type execution
pnpm exec cellas certify --target examples/target.json --profile reference

CLI

pnpm exec cellas --help
pnpm exec cellas version

Contributor path (monorepo):

pnpm build
pnpm exec cellas verify --input samples/reference-execution-001/final-execution-record.json --type execution
pnpm exec cellas certify --target conformance/fixtures/valid/stack-target.json --profile full-reference-stack-v1

Next steps

  1. Quick Start
  2. Examples
  3. Tutorial