Package

Package

One command cleans the project for distribution: remove caches, secrets, and artifacts.

Pipeline

Dry-run → Confirm → Execute → Verify

⚠️ Activate .venv before running scripts.

• Windows: .\.venv\Scripts\Activate.ps1
• macOS/Linux: source .venv/bin/activate

Step 1: Dry Run

Show what will be removed without deleting anything:

python .github/skills/package/scripts/clean.py

Review the output with the user. The script lists:

• 📁 Directories to remove (with sizes)
• 📄 Files to remove (with sizes)
• 🔐 Config values to sanitize (API keys → placeholders)

Step 2: Confirm with User

Before executing, summarize what will be deleted and ask the user to confirm. Offer options:

• --keep-data — preserve data/ and logs/ (useful if user wants to keep ingested documents)
• --no-sanitize — skip API key replacement in config/settings.yaml

Step 3: Execute

# Full clean (removes everything including data)
python .github/skills/package/scripts/clean.py --execute

# Keep data and logs
python .github/skills/package/scripts/clean.py --execute --keep-data

# Skip secret sanitization
python .github/skills/package/scripts/clean.py --execute --no-sanitize

Step 4: Verify

After cleanup, verify the workspace is clean:

# Check no __pycache__ remains
python -c "import pathlib; found=list(pathlib.Path('.').rglob('__pycache__')); print(f'{len(found)} __pycache__ dirs remaining') if found else print('Clean')"

# Check no .venv remains
python -c "import pathlib; print('.venv still exists') if pathlib.Path('.venv').exists() else print('Clean')"

# Check settings.yaml has no real API keys
python -c "
import re, pathlib
text = pathlib.Path('config/settings.yaml').read_text()
keys = re.findall(r'api_key:\s*\"([^\"]+)\"', text)
real = [k for k in keys if k not in ('YOUR_API_KEY_HERE', '')]
print(f'{len(real)} real API key(s) found') if real else print('API keys sanitized')
"

Report results to user.

What Gets Removed

What Gets Sanitized (not removed)

• config/settings.yaml: api_key → "YOUR_API_KEY_HERE", azure_endpoint → placeholder