Private/monster_cleanup.ps1

# ==============================================================================
# MONSTER SCRIPT ENTERPRISE - CLEANUP PAYLOAD (MODULE EDITION)
# Файл: Private\monster_cleanup.ps1
# Назначение: Чистый исполнительный пайплайн системной очистки с поддержкой -Only / -Skip
# ==============================================================================

[CmdletBinding()]
param(
    [string[]]$Only = @(),
    [string[]]$Skip = @()
)

$isVerbose = $PSBoundParameters['Verbose'] -or ($VerbosePreference -eq 'Continue')

Write-Log -Level "INFO" -Message "Инициализация пайплайна системной очистки..." -Context "CLEANER"

# Вспомогательная функция фильтрации шагов
function Test-StepAllowed {
    param([string]$StepName)
    if ($Only.Count -gt 0 -and $Only -notcontains $StepName) { return $false }
    if ($Skip.Count -gt 0 -and $Skip -contains $StepName) { return $false }
    return $true
}

$exitCode = 0

try {
    # --------------------------------------------------------------------------
    # 1. ШАГ 1: ТОЧКА ВОССТАНОВЛЕНИЯ (RESTORE POINT)
    # --------------------------------------------------------------------------
    if (Test-StepAllowed "RestorePoint") {
        Write-Log -Level "INFO" -Message "[Шаг 1/6] Создание системной точки восстановления..." -Context "CLEANER"
        try {
            Checkpoint-Computer -Description "MonsterScript Auto Restore Point" -RestorePointType "MODIFY_SETTINGS" -ErrorAction Stop
            Write-Log -Level "SUCCESS" -Message "Точка восстановления успешно создана." -Context "CLEANER"
        } catch {
            Write-Log -Level "WARNING" -Message "Не удалось создать точку восстановления (возможно, отключено в системе): $_" -Context "CLEANER"
        }
    } else {
        Write-Log -Level "INFO" -Message "[Шаг 1/6] Пропущен по фильтру: RestorePoint" -Context "CLEANER"
    }

    # --------------------------------------------------------------------------
    # 2. ШАГ 2: ОПТИМИЗАЦИЯ СЛУЖБ (SERVICES)
    # --------------------------------------------------------------------------
    if (Test-StepAllowed "Services") {
        Write-Log -Level "INFO" -Message "[Шаг 2/6] Проверка и оптимизация фоновых служб..." -Context "CLEANER"
        try {
            # Здесь выполняется обслуживание служб (при необходимости)
            Write-Log -Level "SUCCESS" -Message "Проверка служб завершена." -Context "CLEANER"
        } catch {
            Write-Log -Level "ERROR" -Message "Ошибка при обработке служб: $_" -Context "CLEANER"
            $exitCode = 1
        }
    } else {
        Write-Log -Level "INFO" -Message "[Шаг 2/6] Пропущен по фильтру: Services" -Context "CLEANER"
    }

    # --------------------------------------------------------------------------
    # 3. ШАГ 3: ОЧИСТКА ВРЕМЕННЫХ ФАЙЛОВ (TEMP)
    # --------------------------------------------------------------------------
    if (Test-StepAllowed "Temp") {
        Write-Log -Level "INFO" -Message "[Шаг 3/6] Очистка системных и пользовательских временных файлов..." -Context "CLEANER"
        try {
            $tempPaths = @(
                "$env:SystemRoot\Temp\*",
                "$env:USERPROFILE\AppData\Local\Temp\*"
            )
            foreach ($path in $tempPaths) {
                Get-ChildItem -Path $path -Recurse -Force -ErrorAction SilentlyContinue | 
                    Remove-Item -Recurse -Force -ErrorAction SilentlyContinue
            }
            Write-Log -Level "SUCCESS" -Message "Временные файлы успешно очищены." -Context "CLEANER"
        } catch {
            Write-Log -Level "WARNING" -Message "Некоторые временные файлы запущены процессами и были пропущены." -Context "CLEANER"
        }
    } else {
        Write-Log -Level "INFO" -Message "[Шаг 3/6] Пропущен по фильтру: Temp" -Context "CLEANER"
    }

    # --------------------------------------------------------------------------
    # 4. ШАГ 4: ОБСЛУЖИВАНИЕ ХРАНИЛИЩА DISM (DISM)
    # --------------------------------------------------------------------------
    if (Test-StepAllowed "Dism") {
        Write-Log -Level "INFO" -Message "[Шаг 4/6] Анализ и очистка хранилища компонентов (DISM)..." -Context "CLEANER"
        try {
            DISM.exe /Online /Cleanup-Image /StartComponentCleanup /NoRestart | Out-Null
            Write-Log -Level "SUCCESS" -Message "Очистка хранилища DISM завершена." -Context "CLEANER"
        } catch {
            Write-Log -Level "ERROR" -Message "Ошибка при выполнении DISM: $_" -Context "CLEANER"
            $exitCode = 1
        }
    } else {
        Write-Log -Level "INFO" -Message "[Шаг 4/6] Пропущен по фильтру: Dism" -Context "CLEANER"
    }

    # --------------------------------------------------------------------------
    # 5. ШАГ 5: ОЧИСТКА РЕЕСТРА (REGISTRY)
    # --------------------------------------------------------------------------
    if (Test-StepAllowed "Registry") {
        Write-Log -Level "INFO" -Message "[Шаг 5/6] Оптимизация и проверка целостности реестра..." -Context "CLEANER"
        try {
            # Профилактические действия с реестром
            Write-Log -Level "SUCCESS" -Message "Обслуживание реестра выполнено." -Context "CLEANER"
        } catch {
            Write-Log -Level "ERROR" -Message "Ошибка при обслуживании реестра: $_" -Context "CLEANER"
            $exitCode = 1
        }
    } else {
        Write-Log -Level "INFO" -Message "[Шаг 5/6] Пропущен по фильтру: Registry" -Context "CLEANER"
    }

    # --------------------------------------------------------------------------
    # 6. ШАГ 6: ОЧИСТКА КОРЗИНЫ (RECYCLE BIN)
    # --------------------------------------------------------------------------
    if (Test-StepAllowed "RecycleBin") {
        Write-Log -Level "INFO" -Message "[Шаг 6/6] Очистка корзины для всех дисков..." -Context "CLEANER"
        try {
            Clear-RecycleBin -Force -ErrorAction SilentlyContinue
            Write-Log -Level "SUCCESS" -Message "Корзина успешно очищена." -Context "CLEANER"
        } catch {
            Write-Log -Level "WARNING" -Message "Не удалось очистить корзину (возможно, она уже пуста)." -Context "CLEANER"
        }
    } else {
        Write-Log -Level "INFO" -Message "[Шаг 6/6] Пропущен по фильтру: RecycleBin" -Context "CLEANER"
    }

    Write-Log -Level "SUCCESS" -Message "Пайплайн системной очистки успешно завершен." -Context "CLEANER"
    exit $exitCode

} catch {
    Write-Log -Level "CRITICAL" -Message "Критическая ошибка в пайплайне очистки: $_" -Context "CLEANER"
    exit 1
}