MQL5-Google-Onedrive/scripts/cleanup_guide.md

Repository Cleanup Guide

This guide helps you clean up pull requests, branches, files, and folders in your repository.

🧹 File & Folder Cleanup

Automated Cleanup

Run the cleanup script to remove temporary files, caches, and logs:

# Dry run (see what would be deleted)
.\scripts\cleanup.ps1 -DryRun

# Clean temporary files
.\scripts\cleanup.ps1 -CleanTemp

# Clean log files (large files > 1MB)
.\scripts\cleanup.ps1 -CleanLogs

# Clean cache files
.\scripts\cleanup.ps1 -CleanCache

# Clean everything
.\scripts\cleanup.ps1 -CleanTemp -CleanLogs -CleanCache

Manual Cleanup

Files/folders that are safe to remove:

• Log files: logs/*.log (if too large)
• Cache directories: __pycache__/, .cache/
• Temporary files: *.tmp, *.swp, *~
• Build artifacts: dist/ (unless needed)
• OS files: .DS_Store, Thumbs.db

Protected Files (DO NOT DELETE)

• config/vault.json - Personal credentials (already in .gitignore)
• dashboard/ - Web dashboard files
• scripts/ - All deployment scripts
• mt5/ - MQL5 source files
• .github/ - GitHub Actions workflows

🌿 Branch Cleanup

List All Branches

# Local branches
git branch

# Remote branches
git branch -r

# All branches
git branch -a

Delete Local Branches

# Delete a specific branch (if already merged)
git branch -d branch-name

# Force delete (even if not merged)
git branch -D branch-name

# Delete multiple merged branches
git branch --merged | Where-Object { $_ -notmatch '\*|main|master' } | ForEach-Object { git branch -d $_.Trim() }

Delete Remote Branches

# Delete a remote branch
git push origin --delete branch-name

# Delete multiple remote branches
git branch -r | Select-String "origin/old-feature" | ForEach-Object {
    $branch = $_.ToString().Trim().Replace("origin/", "")
    git push origin --delete $branch
}

Prune Remote Tracking Branches

# Remove remote tracking branches that no longer exist on remote
git remote prune origin

# Or fetch with prune
git fetch --prune

📋 Pull Request Cleanup

GitHub Pull Requests cannot be deleted via git commands, but you can manage them:

Via GitHub Web Interface

1. Close/Reopen PRs:

   • Go to: https://github.com/A6-9V/MQL5-Google-Onedrive/pulls
   • Click on a PR → Close/Reopen

2. Merge PRs:

   • If approved, click "Merge pull request"
   • Choose merge type (merge commit, squash, rebase)

3. Delete PR Branch (after merge):

   • After merging, GitHub offers to delete the branch
   • Or manually delete: git push origin --delete branch-name

Close Multiple PRs via GitHub API

# Requires GitHub CLI (gh) or API token
# Install GitHub CLI: winget install GitHub.cli

# List open PRs
gh pr list --state open

# Close a specific PR
gh pr close <PR_NUMBER>

# Close multiple PRs by label
gh pr list --label "automerge" --state open | ForEach-Object { gh pr close $_.Split("`t")[0] }

Using GitHub CLI (Recommended)

# Install: winget install GitHub.cli
# Login: gh auth login

# List all PRs
gh pr list

# List open PRs
gh pr list --state open

# Close a PR
gh pr close <PR_NUMBER>

# List merged PRs
gh pr list --state merged

# Check PR status
gh pr view <PR_NUMBER>

🗑️ Common Cleanup Tasks

Clean Up After Merging to Main

# 1. Update main branch
git checkout main
git pull origin main

# 2. Delete merged feature branch locally
git branch -d feature-branch-name

# 3. Delete merged feature branch on remote
git push origin --delete feature-branch-name

# 4. Clean up any temporary files
.\scripts\cleanup.ps1

Bulk Branch Cleanup (Merged Branches)

# Script to delete all merged branches except main
git checkout main
git pull origin main

# Get list of merged branches
$mergedBranches = git branch --merged main | Where-Object {
    $_ -notmatch '\*|main|master'
} | ForEach-Object { $_.Trim() }

# Delete local merged branches
foreach ($branch in $mergedBranches) {
    git branch -d $branch
    Write-Host "Deleted local branch: $branch" -ForegroundColor Green
}

# Delete remote merged branches (be careful!)
foreach ($branch in $mergedBranches) {
    git push origin --delete $branch 2>&1 | Out-Null
    Write-Host "Deleted remote branch: $branch" -ForegroundColor Green
}

Clean Up Large Files from History (if needed)

If you need to remove large files from git history:

# Use git filter-repo (install first: pip install git-filter-repo)
# Or use BFG Repo-Cleaner

# Example: Remove a large file from all history
# WARNING: This rewrites history - coordinate with team first!
# git filter-branch --force --index-filter "git rm --cached --ignore-unmatch path/to/large-file" --prune-empty --tag-name-filter cat -- --all

📊 Repository Size Check

# Check repository size
git count-objects -vH

# Find large files in current state
Get-ChildItem -Recurse -File |
    Sort-Object Length -Descending |
    Select-Object -First 10 Name, @{Name="Size(MB)";Expression={[math]::Round($_.Length / 1MB, 2)}}, FullName

# Find large files in git history
git rev-list --objects --all |
    git cat-file --batch-check='%(objecttype) %(objectname) %(objectsize) %(rest)' |
    Where-Object { $_ -match '^blob' } |
    Sort-Object { [int]($_.Split(' ')[2]) } -Descending |
    Select-Object -First 10

🔒 Safety Tips

1. Always use dry-run first: Test cleanup scripts with -DryRun flag
2. Backup before bulk operations: Create a backup branch before deleting many branches
3. Coordinate with team: Don't delete shared branches without checking
4. Use .gitignore: Ensure temporary files are ignored, not committed
5. Review before deleting: Check branch/PR status before deletion

📝 Maintenance Schedule

Recommended cleanup schedule:

• Weekly: Run cleanup script for temporary files
• After each release: Delete merged feature branches
• Monthly: Review and close stale PRs
• Quarterly: Full repository audit for large files

🆘 Recovering Deleted Items

If you accidentally delete something:

# Recover a deleted branch
git checkout -b branch-name origin/branch-name

# Recover a deleted file (before commit)
git checkout HEAD -- path/to/file

# Recover from reflog
git reflog
git checkout <commit-hash>