Manage Workspace Workflow
Workspace cleanup and archiving commands.
This module implements CLI workflow orchestration for its command family, including argument parsing, request construction, execution dispatch, and result presentation handoff.
Usage context
- Command routing: Resolve CLI aliases and normalized command names.
- Task execution: Build request objects and invoke registered tasks.
- Output handling: Forward results to table, plot, export, or report flows.
Common Runtime and Presentation Arguments
These are shared workflow-level CLI flags added before command-specific options, covering runtime context (engine/input/storage) and output presentation/export behavior.
| Flag | Required | Default | Help | Choices |
|---|---|---|---|---|
--folder |
Yes | Target folder inside workspace. Example: --folder data/raw, which selects the raw-data folder for management. | ||
--action |
No | delete | Action to perform. Example: --action archive, which compresses targets then removes originals when archive succeeds. | list, delete, keep, archive |
--number |
No | 0 | Retention count N. Example: --number 5, which keeps the 5 most recent entries and applies action to older ones. | |
--format |
No | gz | Archive format for --action archive. Example: --format zst, which writes .tar.zst archives. | gz, zst |
--workspace-root |
No | Workspace root path (auto-detected by default). Example: --workspace-root /path/to/reaxkit_workspace, which forces root resolution to that location. | ||
--dry-run |
No | Preview only; do not write/delete files. Example: --dry-run, which shows what would change without modifying disk. | ||
--last |
No | Keep only the latest N raw runs. Example: --last 5, which deletes runs older than the newest five. | ||
--compress |
No | Archive+delete all but latest N runs. Example: --compress 5, which archives older runs and keeps five newest unarchived. | ||
--raw-root |
No | Raw root path (default: |