docs: update CLAUDE.md with v2.13 knowledge

- Update version from 2.12 to 2.13
- Add tests/ folder to project structure
- Document Pester testing framework (94 tests)
- Add CI/CD Pester job description
- Update completed tasks list with v2.11-v2.13 features
- Add v2.13 fixes to known issues table
- Expand testing section with Pester commands
- Add notes about Pester implementation details

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Author: bivlked

CLAUDE.md

@@ -1,7 +1,7 @@
 # WinClean - Инструкции для Claude
 
-> Последнее обновление: 2026-01-17
-> Текущая версия скрипта: 2.12
+> Последнее обновление: 2026-01-18
+> Текущая версия скрипта: 2.13
 
 ---
 
@@ -11,7 +11,7 @@
 
 | Параметр | Значение |
 |----------|----------|
-| **Версия** | 2.12 |
+| **Версия** | 2.13 |
 | **Язык** | PowerShell 7.1+ |
 | **Платформа** | Windows 11 (23H2/24H2/25H2) |
 | **Лицензия** | MIT |
@@ -22,8 +22,8 @@
 ### Статус публикации
 
 - **GitHub**: ✅ Опубликован, активно развивается
-- **PSGallery**: ✅ Опубликован (v2.12, 17.01.2026)
-- **CI/CD**: ✅ GitHub Actions с PSScriptAnalyzer
+- **PSGallery**: ✅ Опубликован (v2.13, 18.01.2026)
+- **CI/CD**: ✅ GitHub Actions (PSScriptAnalyzer + Pester)
 
 ---
 
@@ -41,11 +41,14 @@ CleanScript/
 ├── CLAUDE.md                 # Этот файл — инструкции для Claude
 ├── assets/
 │   └── logo.svg              # Логотип проекта
+├── tests/                    # Pester тесты (v2.13+)
+│   ├── Helpers.Tests.ps1     # Unit-тесты helper-функций (52 теста)
+│   └── Fixes.Tests.ps1       # Валидационные тесты исправлений (42 теста)
 ├── docs/                     # Черновики документации (НЕ в git!)
 │   ├── habr-article.md       # Статья для Хабра
 │   └── habr-article-info.md  # Документация по статье
 └── .github/
-    ├── workflows/ci.yml      # GitHub Actions CI
+    ├── workflows/ci.yml      # GitHub Actions CI (lint + syntax + Pester)
     ├── PULL_REQUEST_TEMPLATE.md
     └── ISSUE_TEMPLATE/       # Шаблоны issues (bug, feature, question)
 ```
@@ -73,7 +76,7 @@ WinClean.ps1 — монолитный скрипт (~2700 строк) с мод
 ### Ключевые переменные
 
 ```powershell
-$script:Version = "2.10"           # Единый источник версии
+$script:Version = "2.13"           # Единый источник версии
 $script:Stats = [hashtable]::Synchronized(@{...})  # Thread-safe статистика
 $script:LogPath = "..."            # Путь к лог-файлу
 $script:ProtectedPaths = @(...)    # Защищённые пути (никогда не удаляются)
@@ -153,24 +156,51 @@ Publish-PSResource -Path .\WinClean.ps1 -Repository PSGallery -ApiKey $env:PSGAL
 
 Файл: `.github/workflows/ci.yml`
 
-**Проверки:**
-- PSScriptAnalyzer (Warning, Error)
-- Синтаксис PowerShell
+**Проверки (3 job'а):**
+1. **lint** — PSScriptAnalyzer (Warning, Error)
+2. **syntax** — Проверка синтаксиса PowerShell
+3. **test** — Pester тесты (94 теста, запускается после lint и syntax)
 
 **Исключения PSScriptAnalyzer** (допустимые для CLI):
 - PSAvoidUsingWriteHost — это интерактивная утилита
 - PSAvoidUsingEmptyCatchBlock — намеренное подавление ошибок
 - PSUseShouldProcessForStateChangingFunctions — не применимо
 
+### Pester тесты (v2.13+)
+
+**Структура тестов:**
+- `tests/Helpers.Tests.ps1` — 52 unit-теста helper-функций
+- `tests/Fixes.Tests.ps1` — 42 валидационных теста исправлений
+
+**Тестируемые функции:**
+- Format-FileSize, ConvertFrom-HumanReadableSize
+- Get-FolderSize, Test-PathProtected
+- Test-InteractiveConsole, Test-PendingReboot
+- Write-Log, Get-RecycleBinSize
+
+**Особенности реализации:**
+- Функции определены напрямую в `BeforeAll` (AST-парсинг не работает в контексте Pester)
+- Используются regex-паттерны для locale-независимых сравнений (`"^1[,.]00 KB$"`)
+- Параметризованные тесты преобразованы в отдельные `It` блоки
+
+**Запуск локально:**
+```powershell
+Install-Module Pester -Force -Scope CurrentUser -MinimumVersion 5.0
+Invoke-Pester ./tests -Output Detailed
+```
+
 ---
 
 ## 7. Текущие задачи и планы
 
 ### Выполнено (январь 2026)
 
-- [x] Публикация в PSGallery (v2.9, затем v2.10)
+- [x] Публикация в PSGallery (v2.9 → v2.13)
 - [x] CI/CD с PSScriptAnalyzer
 - [x] Функция авто-проверки обновлений (v2.10)
+- [x] Таймауты для winget/DISM (v2.11)
+- [x] PS 7.4+ совместимость, улучшенная статистика (v2.12)
+- [x] **Pester тесты — 94 теста** (v2.13)
 - [x] Документация EN/RU синхронизирована
 - [x] Issue templates (bug, feature, question)
 - [x] Черновик статьи для Хабра
@@ -179,6 +209,7 @@ Publish-PSResource -Path .\WinClean.ps1 -Repository PSGallery -ApiKey $env:PSGAL
 
 - [ ] Публикация статьи на Хабре (песочница)
 - [ ] Скриншоты для статьи
+- [ ] Интеграционное тестирование в Hyper-V VM
 
 ### Планы на будущее
 
@@ -275,6 +306,12 @@ Publish-PSResource -Path .\WinClean.ps1 -Repository PSGallery -ApiKey $env:PSGAL
 
 | Проблема | Решение | Версия |
 |----------|---------|--------|
+| Docker regex не парсит новый формат | Обновлён regex для обоих форматов | 2.13 |
+| Browser cache отрицательные значения | `[math]::Max(0, ...)` | 2.13 |
+| Temp paths дублируются | GetFullPath + Group-Object | 2.13 |
+| Get-FolderSize медленный | Добавлен флаг `-File` | 2.13 |
+| PS 7.4 удалил `-UseBasicParsing` | Удалён deprecated параметр | 2.12 |
+| winget статистика при ошибках | Проверка exit code | 2.12 |
 | PSWindowsUpdate зависает при установке | TLS 1.2 + таймауты | 2.9 |
 | Disk Cleanup зависает | Уменьшен таймаут до 7 мин | 2.8 |
 | TotalFreedBytes всегда 0 | Заменён Interlocked на += | 2.3 |
@@ -284,32 +321,38 @@ Publish-PSResource -Path .\WinClean.ps1 -Repository PSGallery -ApiKey $env:PSGAL
 
 ## 12. Тестирование
 
-### Быстрая проверка
+### Автоматические тесты (безопасно на рабочей машине)
 
 ```powershell
-# Режим предпросмотра (без изменений)
-.\WinClean.ps1 -ReportOnly
-```
-
-### PSScriptAnalyzer
+# Pester тесты (94 теста, без изменений системы)
+Invoke-Pester ./tests -Output Detailed
 
-```powershell
+# PSScriptAnalyzer
 Invoke-ScriptAnalyzer -Path .\WinClean.ps1 -Severity Warning,Error
-```
-
-### Синтаксис
 
-```powershell
+# Проверка синтаксиса
 $null = [scriptblock]::Create((Get-Content .\WinClean.ps1 -Raw))
 ```
 
-### Полный запуск
+### Ручное тестирование
 
 ```powershell
-# Требует Admin, создаёт Restore Point
+# Режим предпросмотра (без изменений)
+.\WinClean.ps1 -ReportOnly
+
+# Полный запуск (требует Admin, создаёт Restore Point)
 .\WinClean.ps1
 ```
 
+### Тестирование в изоляции
+
+Для полного интеграционного тестирования рекомендуется Hyper-V VM:
+1. Создать VM с Windows 11 Pro
+2. Создать snapshot "Clean-Install"
+3. Создать "грязную" систему (кэши, корзина, temp файлы)
+4. Создать snapshot "Dirty-System"
+5. Запустить полный прогон и проверить результаты
+
 ---
 
 ## 13. Контакты и ресурсы
@@ -329,6 +372,7 @@ $null = [scriptblock]::Create((Get-Content .\WinClean.ps1 -Raw))
 3. **Обновлять CHANGELOG** — каждое изменение должно быть задокументировано
 4. **Версия в нескольких местах** — см. раздел "Версионирование"
 5. **docs/ не в git** — черновики и рабочие материалы
+6. **Запускать Pester тесты** после изменений helper-функций
 
 ### Что помнить о проекте
 
@@ -337,4 +381,12 @@ $null = [scriptblock]::Create((Get-Content .\WinClean.ps1 -Raw))
 - Поддерживает -ReportOnly для безопасного предпросмотра
 - Лог сохраняется в `%TEMP%\WinClean_*.log`
 - Опубликован в PSGallery — нужен API ключ для публикации
+- **94 Pester теста** в CI/CD — регрессии отслеживаются автоматически
 - Статья для Хабра готова, ждёт скриншоты
+
+### Особенности Pester тестов
+
+- Функции **определены напрямую в BeforeAll** — AST-парсинг не работает в Pester
+- Используются **regex для locale-независимости** (`"^1[,.]00 KB$"` вместо точного сравнения)
+- `-ForEach` параметризация преобразована в **отдельные It блоки** для надёжности
+- Тесты **не модифицируют систему** — безопасны для запуска на рабочей машине