private/Write-HostDateTimeDarkGray.ps1

#Requires -PSEdition Core

function Write-HostDateTimeDarkGray {
    <#
    .SYNOPSIS
        Writes a timestamped informational message in dark gray
 
    .DESCRIPTION
        Prefixes a message with a sortable local timestamp and the INFO label, then
        writes the formatted text directly to the host using the DarkGray foreground
        color. Host text is not written to the success stream.
 
    .PARAMETER Message
        Specifies the text to display. This parameter is mandatory and does not accept a
        null or empty value.
 
    .EXAMPLE
        PS> Write-HostDateTimeDarkGray -Message 'Checking cached files'
 
        Writes the timestamped informational message directly to the host in dark gray.
 
    .INPUTS
        None. This function does not accept pipeline input.
 
    .OUTPUTS
        None.
 
    .NOTES
        Author: David Segura
        Company: Recast Software
        Version: 1.0.0
        Date: 2026-08-28
 
        Requires PowerShell Core.
    #>

    [CmdletBinding()]
    param (
        [Parameter(Mandatory)]
        [ValidateNotNullOrEmpty()]
        [string]$Message
    )

    Write-Host -ForegroundColor DarkGray ("[{0}] [INFO] {1}" -f (Get-Date -format s), $Message)
}