Backup, restore, and retention

woml backup <backup-directory> [--state <path>] [--json]

Creates a coherent online SQLite snapshot plus versioned manifest and checksums. Back up external application databases separately. Back up WOML object storage together with the state boundary when used.

woml restore

woml restore <backup-directory> [--state <path>] [--replace] [--json]

Offline operation that verifies manifest/checksums before restoring. It refuses a live target. --replace is required to replace existing state and retains the previous database as a reported rollback copy.

woml prune

woml prune --before <duration> [--state <path>] [--dry-run] [--compact] [--json]

Removes terminal run history older than the threshold while preserving active or recoverable runs, referenced immutable definitions, durable user state, and other protected data. Start with --dry-run. --compact reclaims SQLite space after successful pruning; deletion alone does not guarantee file shrinkage.