Results

Workspace & History

QUASAR treats the mounted workspace as the center of the run. Understanding that directory model makes restart, cleanup, and result review much easier.

Workspace Layout

A typical workspace includes files like these:

workspace/
├── final_results/
│   └── summary.md
├── logs/
│   ├── usage_report.md
│   ├── execution_overview.md
│   ├── input_messages.md
│   └── conversation.md
├── archive/
│   ├── run_1/
│   └── run_N/
├── docs/
├── .rag_index/
├── checkpoints.sqlite
├── checkpoint_settings.json
└── ...

What Each Area Is For

Path	Purpose
`final_results/`	Final user-facing outputs for the active run.
`logs/`	Run summaries, usage reports, input history, and conversation traces.
`archive/run_N/`	Historical snapshots of completed runs.
`docs/`	Downloaded documentation repositories used for local retrieval and manual inspection.
`.rag_index/`	Cached retrieval index and embedding resources.
`checkpoints.sqlite`	Active checkpoint database that powers resume and history features.
`checkpoint_settings.json`	Stored run settings and usage metadata used during resume and reporting.

What Gets Preserved

docs/ is preserved across normal cleanup and fresh starts
.rag_index/ and other dotfiles are preserved by the CLI cleanup commands
archive/ is preserved when you clear a checkpoint, but removed during a full fresh reset
active checkpoint files stay in place until a run completes or you clear them

Completion Behavior

When a run completes successfully, QUASAR archives the active workspace into archive/run_N/ and removes checkpoint artifacts from the live workspace. That gives you a clean active area while keeping the finished run intact for inspection.

Interrupted Runs

An interrupted run behaves differently from a completed one:

checkpoint files remain in the workspace
the CLI exposes resume behavior
settings are restored from checkpoint metadata
the current run can continue without losing prior progress

Cleanup Modes

The CLI cleanup commands operate on the live workspace only. They do not modify older archived runs unless you choose --fresh.

Action	Keeps `docs/`	Keeps `archive/`	Keeps checkpoint
Clear checkpoint / `--clear`	Yes	Yes	No
Fresh start / `--fresh`	Yes	No	No
Completed run archive	Yes	Yes	Yes

History Surfaces

There are two main ways to inspect past work:

the archived files under workspace/archive/run_N/, which preserve summaries, logs, traces, and generated outputs
the CLI --history command, which lets you inspect checkpoint task history step by step