spec-editor deploy-record (Pro)
Pro command. Available with the spec-editor Pro plugin; the open core does not include it.
Record a deployment: build artifact x host x version/commit.
Journals a deployment/recorded event, overwrites the target
host’s own deployed_commit/deployed_at/deployed_plan_id
attributes, and best-effort emits a lifecycle event to configured
external channels. Idempotent on (host, commit)
or (host, version, deployed_at) — recording the same deployment
twice returns the existing record instead of creating a duplicate.
spec-editor deploy-record -p . --host <id> --version 1.4.2 \
--commit abc123 --change <id> --jsonUsage
spec-editor deploy-record [OPTIONS]Options
| Option | Type | Default | Description |
|---|---|---|---|
--path, -p |
path | . |
Path to project (or SPEC_EDITOR_PROJECT) |
--host |
text | Host element id, or its kind (e.g. prod) when exactly one host has that kind Required. |
|
--version |
text | Version tag (e.g. 1.4.2) | |
--commit |
text | VCS commit | |
--build |
text | Build artifact element id | |
--change |
text | Implementation element id this deployment delivers | |
--status |
one of deploying, failed, live, rolled_back |
live |
Deployment status (default: live) |
--deployed-at |
text | ISO timestamp (default: now, UTC) | |
--json |
flag | Output as JSON |