Troubleshooting

Common fixes for baseline, compare, watch, and license workflow issues.

baseline set says invalid choice

You are running an older CLI build. Activate your current AuditWalk project environment, then reinstall editable mode.

cd /path/to/auditwalk-app
source .venv/bin/activate
python -m pip install -e .
auditwalk baseline set --scan-id <scan_id>

compare --details shows hundreds of changes

This usually means baseline scope is too broad (workspace churn, generated artifacts, multiple repos).

auditwalk scan run --profile quick \
  --roots /path/to/project/src \
  --exclude .git --exclude .venv --exclude __pycache__ \
  --exclude .auditwalk-data --exclude runs --exclude compares
auditwalk baseline set --scan-id <new_scan_id>
auditwalk compare --details

watch command unavailable

Watch requires an entitlement with monitoring support. Free/manual path still works.

auditwalk trust status
auditwalk compare run
auditwalk doctor

Invalid or expired license/trial

If trust status reports invalid_config or expired state, verify local license material first.

auditwalk license status
auditwalk trust status --format json

Output feels circular or unclear

Use trust status as the operator checkpoint. It summarizes baseline, compare, doctor, watch, and entitlement posture in one view.

auditwalk trust status
auditwalk compare --details
auditwalk doctor