Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
3 changes: 1 addition & 2 deletions IT-ToolBox.psd1
Original file line number Diff line number Diff line change
Expand Up @@ -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 = @(
Expand Down Expand Up @@ -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'
}
}
}
23 changes: 16 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down Expand Up @@ -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:

Expand All @@ -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.
Expand Down Expand Up @@ -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:
Expand Down Expand Up @@ -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
Expand Down
4 changes: 3 additions & 1 deletion SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
6 changes: 3 additions & 3 deletions Tests/Packaging.Tests.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
12 changes: 6 additions & 6 deletions docs/Packaging.md
Original file line number Diff line number Diff line change
@@ -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:

Expand All @@ -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.
Expand All @@ -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
```

Expand All @@ -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.
Loading