PSScriptAnalyzerSettings.psd1

@{
    # Only Warning+ severities are enforced in CI (see .github/workflows/ci.yml).
    # A few rules are excluded deliberately, with justification:
    IncludeDefaultRules = $true
    ExcludeRules        = @(
        # Write-TaskAuditConsoleReport's entire job is writing a color-coded
        # report to the host for a human to read interactively -- that is
        # exactly what Write-Host is for, and it is explicitly kept out of
        # the pure-function/testable set for this reason (see the comment
        # at the top of Format-TaskAuditReport.ps1).
        'PSAvoidUsingWriteHost',

        # 'New-TaskFinding', 'Get-TaskScheduleTasks', 'Get-DefaultTaskEnvironmentSearchPaths'
        # etc. are internal nouns chosen for clarity (a "finding", "search
        # paths") rather than forcing awkward singular renames that would
        # hurt readability more than they'd help consistency.
        'PSUseSingularNouns',

        # New-TaskFinding is a pure constructor (builds and returns a
        # PSCustomObject, no side effects) -- the analyzer's ShouldProcess
        # heuristic misfires on the New- verb prefix alone. This module is
        # read-only by design (see README); nothing in it changes system
        # state, so -WhatIf/-Confirm plumbing would be theater, not safety.
        'PSUseShouldProcessForStateChangingFunctions'
    )
}