clean-rebuild

name	clean-rebuild
description	Cleans the SQUANDER repository of build artifacts and rebuilds from scratch. Use when switching branches, after CMakeLists.txt or C++ header changes, when the build state is broken, or before full validation runs.

SQUANDER Clean and Rebuild

When to Use

Use this skill when:

• switching branches;
• after CMakeLists.txt changes;
• after C++ header/interface changes;
• a build/install/import state is broken or inconsistent;
• before a full validation run.

Artifact Inventory (What Must Be Removed)

Remove these artifact categories from the repository root:

• _skbuild/ (scikit-build CMake build tree)
• squander.egg-info/ (editable-install metadata)
• compile_commands.json (regenerated by build)
• squander/**/*.so (compiled extension modules, including libqgd.so)
• **/__pycache__/ (Python bytecode caches)
• build/ and dist/ (packaging directories)

Do not remove squander/src-cpp/gates/squander.egg-info/ from this workflow, because those files are tracked in git in this repository.

Full Clean Command

Run from repository root:

shopt -s globstar nullglob && rm -rf _skbuild build dist squander.egg-info compile_commands.json && rm -f squander/**/*.so && rm -rf **/__pycache__ && shopt -u globstar nullglob

Rebuild Command

Use the standard build/install sequence:

conda activate qgd
export TBB_INC_DIR=~/.conda/envs/qgd/include
export TBB_LIB_DIR=~/.conda/envs/qgd/lib
python setup.py build_ext
python -m pip install -e .

Verification (Smoke Check)

python - << 'EOF'
from squander.density_matrix import DensityMatrix, NoisyCircuit
import numpy as np

rho = DensityMatrix(qbit_num=2)
circuit = NoisyCircuit(2)
circuit.add_H(0)
circuit.add_CNOT(1, 0)
circuit.apply_to(np.array([]), rho)

print("Clean rebuild smoke test: OK")
print("Purity:", rho.purity())
EOF

Safety Notes

This cleanup removes build/runtime artifacts only. It does not remove:

• source files;
• documentation files;
• git history, branches, or commits;
• conda environments.

Canonical Reference

For dependency installation, full verification flow, and troubleshooting, use:

• docs/density_matrix_project/SETUP.md