Weles/Docs

CLI command

weles release adopt

Record what a release published: write the released surface and the version declaration from the surface document that release carried, so the version gate judges later revisions against a real release instead of a hand-kept claim. --source names the published artifact the surface was read from and is written into the baseline as its source, which stado release submit verifies before it builds. Refuses a baseline that moves backwards unless the caller names the version being overridden, a surface document that names nothing, and a missing source ("--source is required").

Purpose#

Record what a release published: write the released surface and the version declaration from the surface document that release carried, so the version gate judges later revisions against a real release instead of a hand-kept claim. --source names the published artifact the surface was read from and is written into the baseline as its source, which stado release submit verifies before it builds. Refuses a baseline that moves backwards unless the caller names the version being overridden, a surface document that names nothing, and a missing source ("--source is required").

Invocation#

Usage
weles release adopt --released <version> --published-surface <file> --reason <text> --source <published artifact> [--correcting <version>] [--json]

Options#

Options of weles release adopt
OptionEffect
--releasedweles --help names this option in the usage line and gives it no description.
--published-surfaceweles --help names this option in the usage line and gives it no description.
--reasonweles --help names this option in the usage line and gives it no description.
--sourceweles --help names this option in the usage line and gives it no description.
--correctingweles --help names this option in the usage line and gives it no description.
--jsonPrint the answer as one JSON document instead of key: value lines. release surface always prints its JSON document: it is the file a release carries.

Help#

`weles release adopt --help` prints these usage lines and never runs the command.