From a56ee27305a2945bb053a23d531b2cc9ae3c79f9 Mon Sep 17 00:00:00 2001 From: Initzero Date: Wed, 14 Oct 2026 13:44:39 +0200 Subject: [PATCH] Prepare 3.0.0 release and invite community testing --- CHANGELOG.md | 11 +++++++++++ IT-ToolBox.psd1 | 3 +-- README.md | 23 ++++++++++++++++------- SECURITY.md | 4 +++- Tests/Packaging.Tests.ps1 | 6 +++--- docs/Packaging.md | 12 ++++++------ 6 files changed, 40 insertions(+), 19 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 195510d..127cbb9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,16 @@ # IT-ToolBox - Change History +## 3.0.0 - 2026-10-14 + +- Remove beta prerelease metadata; retain the 29-command API and PowerShell 7.4 baseline. +- Add a prominent community testing invitation with actionable bug-report guidance. +- Align README, packaging documentation and security support status with 3.0.0. +- Update archive regression expectations for the stable version. + +Live AD, remote CIM and service authentication remain unverified against real +endpoints. This entry records release preparation; a GitHub release or Gallery +publication is a separate action. + ## 3.0.0-beta1 - 2026-10-05 The modernization review is complete. This beta retains the 29-command API and diff --git a/IT-ToolBox.psd1 b/IT-ToolBox.psd1 index 8185658..240b892 100644 --- a/IT-ToolBox.psd1 +++ b/IT-ToolBox.psd1 @@ -5,7 +5,7 @@ Author = 'Daniele Catanesi - PsCustomObject' CompanyName = 'Community' Copyright = '(c) Daniele Catanesi. MIT License.' - Description = 'Reusable infrastructure automation utilities. PowerShell 7 modernization foundation.' + Description = 'Reusable infrastructure automation utilities. PowerShell 7 infrastructure utilities.' PowerShellVersion = '7.4' CompatiblePSEditions = @('Core') FunctionsToExport = @( @@ -47,7 +47,6 @@ Tags = @('Infrastructure', 'Automation', 'Logging') LicenseUri = 'https://github.com/PsCustomObject/IT-ToolBox/blob/master/LICENSE' ProjectUri = 'https://github.com/PsCustomObject/IT-ToolBox' - Prerelease = 'beta1' } } } diff --git a/README.md b/README.md index 0c40ff0..dea7c7c 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,16 @@ [![PowerShell 7.4+](https://img.shields.io/badge/PowerShell-7.4%2B-5391FE?logo=powershell)](https://github.com/PowerShell/PowerShell) [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE) -[![Status: Beta Preview](https://img.shields.io/badge/status-beta%20preview-orange.svg)](./CHANGELOG.md) +[![Version: 3.0.0](https://img.shields.io/badge/version-3.0.0-blue.svg)](./CHANGELOG.md) +[![Testing wanted](https://img.shields.io/badge/testing-wanted-yellow.svg)](https://github.com/PsCustomObject/IT-ToolBox/issues/new/choose) + +> **Testing wanted — help validate IT-ToolBox 3.0.0 in real environments.** +> Feedback is especially useful for Windows AD report chains, remote CIM uptime, +> API authentication and platform clipboard behavior. +> [Report a bug](https://github.com/PsCustomObject/IT-ToolBox/issues/new/choose) +> with the command, expected/actual result, OS, PowerShell version and commit or +> module version. Redact credentials and private data; report vulnerabilities +> through [the private security reporting route](./SECURITY.md). PowerShell utilities for enterprise automation, secure logging, identity validation, and cross-platform operational tooling. @@ -75,9 +84,9 @@ review, and adapt in production automation. ## Project status and roadmap -This repository is currently an active modernization preview. The codebase is intended -for practical use, but the project is still evolving and compatibility expectations -should be reviewed before adopting it broadly in production automation. +The module now targets the **3.0.0 release**. The supported API is covered by +cross-platform regression tests. Community testing is welcome, particularly for +the live integrations described below. Review the v2 migration notes before upgrading. Current roadmap focus: @@ -89,7 +98,7 @@ Current roadmap focus: ## Status and requirements -This is the **3.0.0-beta1 modernization preview**. The modernization review is +This is **IT-ToolBox 3.0.0**. The modernization review is complete; live AD, remote CIM and service authentication remain unverified. Requires PowerShell 7.4 or later (Core edition). Windows PowerShell 5.1 is not supported. @@ -123,7 +132,7 @@ New-PhoneticPassword -PasswordLength 16 -NoPasswordSpell This imports the local manifest; it does not install the module globally. Import it again in each new PowerShell session, using an absolute path when running elsewhere. -The master branch contains ongoing preview development. Record the commit used by +The master branch contains ongoing development. Record the commit used by your automation with `git rev-parse HEAD`; updating your clone can change behavior. To update an existing clone, first commit or otherwise preserve local changes, then: @@ -216,7 +225,7 @@ Redaction is opt-in and does not guarantee detection of every secret. ## Tests and CI -For a clean installable preview archive, run `./scripts/Build-Module.ps1` in +For a clean installable module archive, run `./scripts/Build-Module.ps1` in PowerShell after running the tests. The archive includes supported module code and documentation, excluding Legacy, Staging and development files. See [build and installation instructions](./docs/Packaging.md). Nothing is published diff --git a/SECURITY.md b/SECURITY.md index 6655f71..13db284 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -22,7 +22,9 @@ If a report touches credentials, secrets, or sensitive operational data, redact ## Supported versions -This project is currently in active preview development. Security fixes are prioritized based on impact and maintainability, but the project does not yet provide a formal long-term support matrix for every version. +Security fixes target the latest 3.x release. Older major versions and archived +legacy helpers are not maintained. Report issues against the current version +where possible; fixes are prioritized based on impact and maintainability. ## Security expectations diff --git a/Tests/Packaging.Tests.ps1 b/Tests/Packaging.Tests.ps1 index ebb0d44..88f7b9c 100644 --- a/Tests/Packaging.Tests.ps1 +++ b/Tests/Packaging.Tests.ps1 @@ -8,9 +8,9 @@ BeforeAll { } Describe 'Installable module packaging' { - It 'uses the manifest preview version and conventional module layout' { - $package.Version | Should -Be '3.0.0-beta1' - [IO.Path]::GetFileName($package.ArchivePath) | Should -Be 'IT-ToolBox-3.0.0-beta1.zip' + It 'uses the manifest release version and conventional module layout' { + $package.Version | Should -Be '3.0.0' + [IO.Path]::GetFileName($package.ArchivePath) | Should -Be 'IT-ToolBox-3.0.0.zip' Test-ModuleManifest (Join-Path $moduleRoot 'IT-ToolBox.psd1') -ErrorAction Stop | Should -Not -BeNullOrEmpty foreach ($name in @('LICENSE', 'CONTRIBUTING.md', 'SECURITY.md')) { Test-Path -LiteralPath (Join-Path $moduleRoot $name) | Should -BeTrue diff --git a/docs/Packaging.md b/docs/Packaging.md index e4c39fb..17ebd1b 100644 --- a/docs/Packaging.md +++ b/docs/Packaging.md @@ -1,4 +1,4 @@ -# Build and install the modernization preview +# Build and install the module Run from the repository root using PowerShell 7.4 or later: @@ -7,7 +7,7 @@ Invoke-Pester ./Tests ./scripts/Build-Module.ps1 ``` -The script creates artifacts/IT-ToolBox-3.0.0-beta1.zip and returns its path, +The script creates artifacts/IT-ToolBox-3.0.0.zip and returns its path, version and file count. It takes the version from the manifest without modifying it. Use -OutputDirectory to choose another local destination. An existing archive causes a terminating error; use a different destination for another build. @@ -22,8 +22,8 @@ in a separate session; the old decoder is not distributed in this archive. Extract into a new directory, then verify or import the extracted manifest: ```powershell -Expand-Archive -LiteralPath './artifacts/IT-ToolBox-3.0.0-beta1.zip' -DestinationPath './preview-install' -Import-Module './preview-install/IT-ToolBox/3.0.0/IT-ToolBox.psd1' -Force +Expand-Archive -LiteralPath './artifacts/IT-ToolBox-3.0.0.zip' -DestinationPath './module-install' +Import-Module './module-install/IT-ToolBox/3.0.0/IT-ToolBox.psd1' -Force Get-Command -Module IT-ToolBox ``` @@ -34,5 +34,5 @@ this script does not install or replace a module for you. CI runs archive-content and fresh-process import tests on Windows, Linux and macOS, then builds the archive locally. No publishing, release creation or signing is performed. ZIP timestamps are not normalized, so identical source builds need not -have identical archive hashes. This remains a beta preview; the package process -does not establish live AD, remote CIM or service authentication compatibility. +have identical archive hashes. The package process does not establish live AD, remote CIM or service +authentication compatibility; community integration testing is welcome.