command:envelope

`command:envelope@0.0.0`

A document is written as one of commandEnvelope.

`manifestInfo`

Field	Type	Required	Default	Description
`path`	`string`	Yes		Path of the manifest file the run resolved

`errorDetail`

Field	Type	Required	Default	Description
`code`	`string`	Yes		The error's code, such as `MANIFEST_VALIDATION_FAILED`: what a caller matches on and a reader searches for
`message`	`string`	Yes		What went wrong, in words, for whoever reads the answer

`commandData`

Field	Type	Required	Default	Description
`value`	`any`	Yes		The command's answer, written to the definition its config names as `output`; null where the run was refused before the command answered

`commandEnvelope`

Field	Type	Required	Default	Description
`schemaVersion`	`version`	Yes		The version of this document's schema that this document was written under -- granted by the meta-schema to every definition named in `metadata.documentRoots`, never declared
`command`	`string`	Yes		The name of the command that ran, without the group it was invoked under
`commandVersion`	`version`	No		The version of the contract the answering command declares in its config, absent from a refusal made before the command config was read
`resource`	`string`	No		The group the command was invoked under, the nearest where groups nest; absent for a command with none
`status`	`string`	Yes		`success` where `exitCode` is 0, and `error` otherwise
`exitCode`	`integer`	Yes		The code the process exits with: 0 for a success
`startedAt`	`string`	Yes		When the run started, in UTC as ISO 8601 to the whole second: `2026-01-31T12:00:00Z`
`endedAt`	`string`	Yes		When the command answered, in UTC as ISO 8601 to the whole second
`durationMs`	`integer`	Yes		Milliseconds from the run's start to its answer, taken before either time is cut to the second
`repoRoot`	`string`	Yes		The root of the repository the run acted on; as the run was given it where it was refused before the root was settled
`manifest`	`manifestInfo`	No		The manifest the command ran against; absent for an application that reads none
`data`	`commandData`	Yes		The command's answer, under `value`
`errors`	`list[errorDetail]`	Yes		The errors the run answered with, in order; empty where there were none