QuietCli: useful answers beyond smaller CLI output📋

{"Branch":"main","Changed":1,"Untracked":1,"Clean":false,"AnswerComplete":true}

#requires -Version 7.4
#requires -PSEdition Core

$repository = 'C:/code/my-project'
$moduleRoot = 'C:/tools/QuietCli'
Import-Module (Join-Path $moduleRoot 'QuietCli.PoSh.psd1') -ErrorAction Stop
$repositoryPath = [IO.Path]::GetFullPath($repository)

# The agent writes the commands, parser and calculations for this question.
$result = Invoke-QuietTask -MaxOutputBytes 2048 -ArgumentList @($repositoryPath) -ScriptBlock {
    param($repo)

    $branch = Invoke-QuietStep branch {
        Invoke-QuietCli -FilePath git -ArgumentList @('branch', '--show-current') `
            -WorkingDirectory $repo -Summary 'Current branch extracted.' -Parse {
                param($capture)
                $name = $capture.Stdout.Trim()
                [pscustomobject]@{ Name = $name; Detached = ($name.Length -eq 0) }
            }
    }
    if ($branch.Outcome -ne 'Success') { return }

    $state = @{ Changed = 0L; Untracked = 0L; SkipRenameSource = $false }
    $status = Invoke-QuietStep status {
        Invoke-QuietCli -FilePath git `
            -ArgumentList @('status', '--porcelain=v1', '-z', '--untracked-files=normal') `
            -WorkingDirectory $repo -RecordDelimiter ([char]0) -State $state `
            -Summary 'Git status counted locally.' -OnRecord {
                param($record, $state)
                if ($record.Stream -ne 'stdout' -or $record.Truncated) { return }
                if ($state.SkipRenameSource) { $state.SkipRenameSource = $false; return }
                if ($record.Text.Length -lt 4 -or $record.Text[2] -ne ' ') {
                    throw 'Unsupported Git status record.'
                }

                $code = $record.Text.Substring(0, 2)
                if ($code -eq '??') { $state.Untracked++ }
                else {
                    $state.Changed++
                    # A rename/copy has a second NUL-delimited path, not another entry.
                    if ($code.Contains('R') -or $code.Contains('C')) {
                        $state.SkipRenameSource = $true
                    }
                }
            } -Complete {
                param($state, $capture)
                if ($state.SkipRenameSource) { throw 'Incomplete rename record.' }
                [pscustomobject]@{ Changed = $state.Changed; Untracked = $state.Untracked }
            }
    }
    if ($status.Outcome -ne 'Success') { return }

    [pscustomobject]@{
        Branch = $branch.Data.Name
        Detached = $branch.Data.Detached
        Changed = $status.Data.Changed
        Untracked = $status.Data.Untracked
        Clean = ($status.Data.Changed -eq 0 -and $status.Data.Untracked -eq 0)
        AnswerComplete = $true
    }
}

if ($result.Outcome -ne 'Success' -or
    $result.Execution.AnalysisComplete -ne $true -or
    $result.Truncation.Applied -or
    $result.Data.AnswerComplete -ne $true) {
    throw "Git overview is incomplete: $($result.Outcome). Inspect the full result."
}

# Keep $result for its execution diagnostics; display only the five domain fields.
$result.Data |
    Select-Object Branch, Changed, Untracked, Clean, AnswerComplete |
    ConvertTo-Json -Compress

$moduleRoot = 'C:/tools/QuietCli'
& (Join-Path $moduleRoot 'scripts/Invoke-Examples.ps1') -QuietCliRoot $moduleRoot -Python python3

$moduleRoot = 'C:/code/FrenchExDev/FrenchExDev_i2/PoSh/FrenchExDev/FrenchExDev.QuietCli.PoSh'
& (Join-Path $moduleRoot 'scripts/Invoke-Examples.ps1') -QuietCliRoot $moduleRoot `
    -Python python3