Reads the summary for one branch: name, deterministic branch id, generation, status, parent lineage, and logical creation version. A branch that does not exist is a not_found.engine.branch error, not an empty result.

Status commands return a scalar or compact status payload and do not mutate database state.

Examples

Read one branch by name.

CLI

$ strata branch create feature
$ strata branch get feature

Wire

{"branch":"feature","type":"branch_create"}
{"branch":"feature","type":"branch_get"}

Parameters

No parameters.

Plus the optional scope: branch and space (default to the session branch and the "default" space).

Returns

StatusResponse<BranchItem>.

Errors

• failed_precondition.engine.runtime_closed
• not_found.engine.branch
• invalid_argument.engine.branch_name
• invalid_argument.engine.branch_name_reserved

Invocation

• CLI: strata branch get
• Wire type: branch_get