scripts/maintenance/README.md

Maintenance Scripts

System maintenance, cleanup, and development utilities.

Cleanup Scripts

cleanup_disk_space.sh

Frees up disk space by removing temporary files and caches.

Usage:

./scripts/maintenance/cleanup_disk_space.sh

What it removes:

• Docker images and containers
• Python cache files
• Node.js cache
• Temporary build artifacts

⚠️ Does NOT remove:

• Application data cache (data/cache/)
• Database files
• Important project data

cleanup_frontend_junk.sh

Removes frontend build artifacts and dependencies.

Usage:

./scripts/maintenance/cleanup_frontend_junk.sh

docker-cleanup.sh

Docker-specific cleanup (removes unused images, containers, volumes).

Usage:

./scripts/maintenance/docker-cleanup.sh

What it cleans:

• Stopped containers
• Unused images
• Dangling volumes
• Unused networks

Project Maintenance

migrate-docs.sh

Migrates documentation from project root to website/docs/ (Docusaurus format).

Usage:

./scripts/maintenance/migrate-docs.sh

What it does:

• Moves .md files from root to website/docs/
• Adds YAML frontmatter
• Converts filenames to kebab-case

System Utilities

prevent_terminal_corruption.sh

Prevents terminal corruption from Unicode characters.

Usage:

source scripts/maintenance/prevent_terminal_corruption.sh

move_secrets_to_home.sh

Moves secrets to home directory for security.

Usage:

./scripts/maintenance/move_secrets_to_home.sh

Development

test-app.py

Quick test script for application functionality.

Usage:

python scripts/maintenance/test-app.py