Maintenance Scripts

Personal Windows maintenance scripts — minimal, traceable, Turkish and English.

Kişisel Windows bakım betikleri — sade, izlenebilir, Türkçe ve İngilizce.

Language / Dil: English · Türkçe

---

English

What is this?

Each script does one job: it runs commands in order and writes output both to the console and to its own log folder. No menus, no options, no surprises.

Scripts

Script	Does
Repair-Windows.bat	DISM + SFC + WinSxS maintenance (includes ResetBase)
Reset-Windows-Update.bat	Reset Windows Update components
Clear-DnsClientCache.bat	Flush DNS cache
WinGet-Upgrade.bat	Upgrade all packages (winget)
Update-Components.bat	Upgrade Python/pip, pipx itself and pipx-managed packages, and Node.js/npm global packages
Bug-Report.ps1	Event log HTML report (-Period Daily, Weekly, Monthly)

Usage

1. Run Scripts/<name>.bat as administrator (right-click → Run as administrator); only Repair-Windows.bat and Reset-Windows-Update.bat require it.
2. Each script logs under Logs/<Script-Name>/; every folder keeps an index.txt run ledger.
3. Bug-Report.ps1 runs on a schedule: pwsh.exe -NoProfile -ExecutionPolicy Bypass -File "Scripts\Bug-Report.ps1" -Period Daily (use powershell.exe on a host without PowerShell 7)
4. Update-Components.bat upgrades Python/pip, pipx itself and pipx-managed packages, and Node.js/npm global packages (user scope). It forwards arguments to Tools/Update-Components.ps1. Dry-run: Scripts\Update-Components.bat -Check or powershell -NoProfile -File Tools/Update-Components.ps1 -Check JSON report (CI/CD): add -ReportPath Logs\Update-Components\run.json (schema v1; works with -Check or a real run). Note: global npm packages are upgraded to the latest available version (including major versions) after npm outdated -g is rechecked; review -Check output first because major upgrades can change global CLI behavior.

Rules

• Runtime artifacts are excluded from version control (see .gitignore); scripts create and use their Logs/ folder at runtime.
• Console and log output are identical.
• A mojibake/encoding gate (Tools/Check-Mojibake.ps1) blocks double-encoded text and invalid UTF-8 in files, commits, and release text; run git config core.hooksPath .githooks to arm the bundled local hooks.
• See CONTRIBUTING.md for contributions, SUPPORT.md for help, PRIVACY.md for data handling, and SECURITY.md for security.
• Docs index: CHANGELOG.md (version history), NOTICE (attribution), CODE_OF_CONDUCT.md (conduct), CODEOWNERS (reviewers), RELEASE-NOTE-TEMPLATE.md (release skeleton), AGENTS.md (agent working rules).
• Guides: Docs/Overview-And-Setup.md, Docs/Architecture.md, Docs/Troubleshooting.md.

---

Türkçe

Nedir?

Her betik tek iş yapar: komutları sırayla çalıştırır, çıktıyı hem ekrana hem de kendi günlük klasörüne yazar. Menü yok, seçenek yok, sürpriz yok.

Betikler

Betik	İş
Repair-Windows.bat	DISM + SFC + WinSxS bakımı (ResetBase dahil)
Reset-Windows-Update.bat	Windows Update bileşenlerini sıfırlama
Clear-DnsClientCache.bat	DNS önbelleğini temizleme
WinGet-Upgrade.bat	Tüm paketleri yükseltme (winget)
Update-Components.bat	Python/pip, pipx ve Node.js/npm global paketlerini yükseltme
Bug-Report.ps1	Olay günlüğü HTML raporu (-Period Daily, Weekly, Monthly)

Kullanım

1. Scripts/ klasöründeki betiği yönetici olarak çalıştırın (sağ tık → Yönetici olarak çalıştır); bunu yalnızca Repair-Windows.bat ve Reset-Windows-Update.bat gerektirir.
2. Her betik günlüğünü Logs/<Betik-Adı>/ altına yazar; her klasörde index.txt koşu dökümünü tutar.
3. Bug-Report.ps1 Zamanlayıcı ile koşar: pwsh.exe -NoProfile -ExecutionPolicy Bypass -File "Scripts\Bug-Report.ps1" -Period Daily (PowerShell 7 yoksa powershell.exe kullanın)
4. Update-Components.bat, Python/pip, pipx kendi kendine ve pipx yönetimli paketleri, ve Node.js/npm global paketlerini yükseltir (kullanıcı kapsamı). Bağımsız değişkenleri Tools/Update-Components.ps1 betiğine iletir. Kuru çalıştırma: Scripts\Update-Components.bat -Check veya powershell -NoProfile -File Tools/Update-Components.ps1 -Check JSON raporu (CI/CD): -ReportPath Logs\Update-Components\run.json ekleyin (şema v1; -Check veya gerçek çalıştırmayla kullanılabilir). Not: global npm paketleri, npm outdated -g yeniden kontrol edildikten sonra en son sürüme yükseltilir (major sürümler dâhil); major yükseltmeler global CLI davranışını değiştirebileceği için önce -Check çıktısını gözden geçirin.

Kurallar

• Çalışma zamanı yapıları sürüm kontrolünün dışındadır (ayrıntı .gitignore); betikler Logs/ klasörünü çalışırken kendileri açar ve kullanır.
• Çıktı hem ekranda hem günlükte birebir aynıdır.
• Katkı için CONTRIBUTING.md, destek için SUPPORT.md, gizlilik için PRIVACY.md ve güvenlik için SECURITY.md dosyasına bakın.
• Belge dizini: CHANGELOG.md (sürüm geçmişi), NOTICE (atıflar), CODE_OF_CONDUCT.md (davranış), CODEOWNERS (gözden geçirenler), RELEASE-NOTE-TEMPLATE.md (yayın iskeleti), AGENTS.md (ajan çalışma kuralları).
• Kılavuzlar: Docs/Overview-And-Setup.md, Docs/Architecture.md, Docs/Troubleshooting.md.
• Dosyalarda, commitlerde ve yayın metinlerinde çift kodlanmış metni ve geçersiz UTF-8'i engelleyen bir bozuk-kodlama geçidi (Tools/Check-Mojibake.ps1) vardır; paketlenmiş yerel kancaları kurmak için git config core.hooksPath .githooks çalıştırın.