Skip to content

v1.0.5

Choose a tag to compare

@Ahmed-Yaseen99 Ahmed-Yaseen99 released this 07 Sep 22:59
· 58 commits to main since this release

unslop-windows v1.0.5

Added

  • Automated Static Symmetry Verification via AST Parity Check (tests/unslop.Tests.ps1): Added 5 automated static AST parity tests using PowerShell's Abstract Syntax Tree parser ([System.Management.Automation.Language.Parser]::ParseFile) to enforce 100% Symmetrical Restoration Contract invariants:
    1. Every Set-RegDwordSafe call defines both debloat and undo values.
    2. Zero naked mutating cmdlets (Set-ItemProperty, Remove-ItemProperty, Set-Service, Stop-Service, Disable-ScheduledTask, Remove-AppxPackage) exist outside approved defensive helper functions.
    3. Every Set-SvcState service call defines a valid restore startup type (Automatic or Manual).
    4. Core engine helper functions maintain strict bidirectional symmetry.
    5. Firewall hardening loop implements bidirectional rule transitions.
  • Native Pester Code Coverage & JaCoCo Reporting (scripts/Test-MasterGate.ps1): Added -CodeCoveragePath parameter enabling native Pester 5 code coverage on unslop.ps1 with JaCoCo XML output and console coverage metric reporting.
  • GitHub Actions Coverage Summaries & Step Metrics (.github/workflows/lint.yml): Automated JaCoCo XML parsing in CI, rendering line and instruction code coverage tables directly into $env:GITHUB_STEP_SUMMARY and archiving coverage artifacts.
  • Version-Controlled Static Analysis Ruleset (PSScriptAnalyzerSettings.psd1): Created repository-level analyzer configuration enforcing Error and Warning rules (PSAvoidUsingCmdletAliases, PSAvoidUsingEmptyCatchBlock, PSAvoidUsingPlainTextForPassword, PSAvoidUsingInvokeExpression, PSAvoidUsingUsernameAndPasswordParams) with dynamic binding in Test-MasterGate.ps1.
  • GitHub Actions Supply Chain Hardening & SLSA Build Provenance (.github/workflows/): Pinned all third-party actions to immutable 40-character commit SHAs (actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683, actions/upload-artifact@4cec3d8aa04e39d1a68397de0c4cd6fb9dce8ec1). Integrated actions/attest-build-provenance@e8998f949152b193b063cb0ec769d69d929409be in release.yml for cryptographic SLSA build provenance attestations on release zip bundles and SHA256SUMS.txt.
  • Architectural Decision Records (docs/decisions.md): Added ADR-013 (AST Parity Symmetry Verification), ADR-014 (Native Pester Code Coverage), ADR-015 (Static Analysis Ruleset) and ADR-016 (Supply Chain Hardening & SLSA Provenance).

Quick Installation & Usage

  1. Download unslop-windows-v1.0.5.zip from Assets below.
  2. Extract the archive to any directory.
  3. Right-click unslop.bat and choose Run as administrator (or double-click and accept the UAC elevation prompt).
  4. Select an option from the interactive menu:
    • [1] Full Debloat: Remove OneDrive, telemetry and provisioned bloatware.
    • [2] Gamer Preset: Debloat, keep Xbox & Gaming Services (-KeepXbox).
    • [3] Productivity Preset: Debloat, keep OneDrive & Microsoft To-Do (-KeepOneDrive -KeepTodos).
    • [4] Interactive Toggles: Configure custom feature combinations with visual toggle states.
    • [5] Safe Dry-Run Audit: Inspect all changes safely with zero system modifications (-DryRun).
    • [6] Full Restore / Undo: Symmetrically revert all tweaks back to defaults (-Undo).
    • [7] Custom CLI Flags: Manually enter parameter switches (e.g. -KeepTodos -KeepXbox -NoRestart).
    • [0] Exit: Close the launcher.

Verification & Integrity

Verify archive integrity using the published SHA256SUMS.txt:

Get-FileHash .\unslop-windows-v1.0.5.zip -Algorithm SHA256