skarbiec purge

Invocation#

skarbiec purge <id> --yes

Purpose#

Permanently remove a trashed owner-controlled item and every saved version of it.

Required inputs and options#

• Requires one item id and --yes, the confirmation that the removal cannot be undone. The desktop's Purge Permanently dialog is the same confirmation for the operator API.

Output and state effects#

• With --yes, removes the item's stored record and revisions, then prints { ok: true }.

Refusals#

• Without --yes it refuses with 'purge would remove <id> and every saved version of it for good; nothing was removed. Rerun with --yes to purge it, or restore <id> to keep it' and exit status 1, after the lifecycle check. Refuses direct owner removal of lifecycle-controlled items and records that do not satisfy the vault's purge preconditions. A missing id exits 2.