Platform Reference

This section documents the internal layers of the strata CLI.

What’s Here

Document

Contents

commands.md

Full CLI command reference — every command group, option, and exit code

workflow.md

End-to-end DevOps workflow guide (init → validate → build → deploy)

cli-preferences.md

Persistent CLI defaults via env vars or workspace config

architecture.md

Multi-repository structure and deployment workflow overview

exit-codes.md

Exit code definitions and per-command usage table

models.md

Pydantic v2 model schema, field constraints, and validation phases

services.md

Service layer — BaseService, load/cache lifecycle, two-phase validation

configuration.md

ConfigurationService — load order, repo map, merge strategy

integrations.md

Integration layer — factory, singleton lifecycle, subprocess wrapping

sbom-plugin-api.md

SBOM plugin API — BaseSbomCollector, LockfileParser base classes

builders.md

Build pipeline — PlatformBuilder, TerraformBuilder, artifact output

deployers.md

Deploy pipeline — deployer table, step constants, execution order

validators.md

Validation pipeline — BaseValidator, PlatformValidator

policies.md

Policy engine — built-in policy types, configuration, evaluation phases

lifecycles.md

Lifecycle hooks — phase naming, script execution, env variables

exceptions.md

Exception hierarchy — PlatformError subclasses and usage

logging.md

Structured logging — get_logger, structlog config, YAML config files

utilities.md

Pure utility functions — path resolution, system helpers