CLI reference / product / build-trees

stado product build-trees

Invocation

stado product build-trees [OPTIONS] <operation>

Purpose

List or remove the rebuildable trees in the workspace's checkouts — CACHEDIR.TAG directories, Stado's former install runs, desktop .build — from this process

Required inputs and options

Input or optionContract
<operation>list: every rebuildable tree with its bytes and whether a build holds it; remove: delete every one no build holds and report the bytes [possible values: list, remove]
--catalog <catalog>Independent authoritative catalog path
--jsonPrint every tree, its bytes and its state as JSON
--workspace <workspace>The workspace of canonical checkouts this operation reads and builds from; default WISENT_WORKSPACE, else ~/Documents/CodingProjects/Wisent

Output and state effect

This is an inspection/reporting operation. It emits the result described above and does not change managed state unless an explicit option in this page says otherwise. Pass `--json` when the command exposes that machine-readable option.

Refusals

  • Before dispatch, Stado refuses a missing required token shown in the invocation, an unknown option, or a value outside a listed value set; argument-usage failures exit with code 2.