shrinker-ai 0.3.3 → 0.4.0

package/integrations/windows/install.ps1

@@ -1,113 +1,161 @@
-param(
-    [switch]$Local,
-    [string]$PackageName = "shrinker-ai",
-    [string]$Registry = "https://registry.npmjs.org",
-    [string]$Version,
-    [switch]$SkipNpmInstall,
-    [switch]$SkipBuild,
-    [switch]$SkipLink,
-    [switch]$EnableProfileRouting,
-    [switch]$SkipProfile,
-    [switch]$SkipAgentRules,
-    [switch]$CopilotOnly,
-    [switch]$ClaudeOnly,
-    [string]$ProfilePath = $PROFILE,
-    [int]$StepOffset = 0
-)
-
-$ErrorActionPreference = "Stop"
-$InstallStep = $StepOffset
-
-function Write-InstallStep {
-    param([string]$Emoji, [string]$Message)
-    $script:InstallStep++
-    Write-Host "$($script:InstallStep). $Emoji $Message"
-}
-
-if ($EnableProfileRouting -and $SkipProfile) { throw "Use either -EnableProfileRouting or -SkipProfile, not both." }
-if ($CopilotOnly -and $ClaudeOnly) { throw "Use either -CopilotOnly or -ClaudeOnly, not both." }
-
-function Set-AgentRules {
-    param([string]$Body)
-    $start = "<!-- shrinker agent rules start -->"
-    $end = "<!-- shrinker agent rules end -->"
-    foreach ($target in @((Join-Path $HOME ".copilot\copilot-instructions.md"), (Join-Path $HOME ".claude\CLAUDE.md"))) {
-        if ($ClaudeOnly -and $target.EndsWith(".copilot-instructions.md")) { continue }
-        if ($CopilotOnly -and $target.EndsWith("CLAUDE.md")) { continue }
-        New-Item -ItemType Directory -Path (Split-Path $target) -Force | Out-Null
-        $content = if (Test-Path $target) { Get-Content $target -Raw } else { "" }
-        $block = "$start`n$Body`n$end"
-        if ($null -ne $content -and $content.Contains($start) -and $content.Contains($end)) {
-            $content = [regex]::Replace($content, [regex]::Escape($start) + ".*?" + [regex]::Escape($end), $block, 'Singleline')
-            Set-Content $target $content
-        } elseif ($content) { Add-Content $target "`n$block`n" }
-        else { Set-Content $target "$block`n" }
-        Write-InstallStep "📄" "Installed managed rules in: $target"
-    }
-}
-
-function Add-ProfileIntegration {
-    param([string]$ProfileFile, [string]$IntegrationFile)
-    if (-not (Test-Path $ProfileFile)) { New-Item -ItemType File -Path $ProfileFile -Force | Out-Null }
-    $start = "# >>> shrinker integration >>>"
-    if ((Get-Content $ProfileFile -Raw).Contains($start)) { return }
-    Add-Content $ProfileFile "`n$start`n. `"$IntegrationFile`"`n# <<< shrinker integration <<<`n"
-    Write-InstallStep "🔧" "Added shrinker integration block to profile: $ProfileFile"
-}
-
-if (-not $Local) {
-    $packageSpec = if ($Version) { "$PackageName@$Version" } else { $PackageName }
-    Write-InstallStep "📦" "Installing $packageSpec from $Registry..."
-    & npm install --silent --global $packageSpec "--registry=$Registry"
-    if ($LASTEXITCODE -ne 0) { throw "npm package installation failed." }
-    Write-InstallStep "🔎" "Locating the installed package..."
-    $globalRoot = (& npm root --global).Trim()
-    if (-not $globalRoot) { throw "Could not determine the global npm package directory." }
-    $packageRoot = Join-Path $globalRoot ($PackageName -replace '/', '\')
-    $entrypoint = Join-Path $packageRoot "integrations\windows\install.ps1"
-    if (-not (Test-Path $entrypoint)) { throw "Installed package installer not found: $entrypoint" }
-    Write-InstallStep "⚙️" "Configuring the installed package..."
-    & pwsh -ExecutionPolicy Bypass -File $entrypoint -Local -SkipNpmInstall -SkipBuild -SkipLink -EnableProfileRouting:$EnableProfileRouting -SkipProfile:$SkipProfile -SkipAgentRules:$SkipAgentRules -CopilotOnly:$CopilotOnly -ClaudeOnly:$ClaudeOnly -ProfilePath $ProfilePath -StepOffset $InstallStep
-    if ($LASTEXITCODE -ne 0) { throw "Repository installer failed with exit code $LASTEXITCODE" }
-    return
-}
-
-$scriptDir = $PSScriptRoot
-$repoRoot = (Resolve-Path (Join-Path $scriptDir "..\..")).Path
-$templatePath = Join-Path $repoRoot "templates\agent-rules.md"
-$integrationPath = (Resolve-Path (Join-Path $scriptDir "shrinker-profile.ps1")).Path
-if (-not $SkipAgentRules) {
-    if (-not (Test-Path $templatePath)) { throw "Agent rules template not found: $templatePath" }
-    $rulesBody = Get-Content $templatePath -Raw
-}
-
-$versionText = & node -v 2>$null
-if (-not $versionText) { throw "Node.js was not found on PATH. Install Node.js 22.13+ first." }
-$version = [version]($versionText.TrimStart('v'))
-if ($version -lt [version]'22.13.0') { throw "Node.js 22.13+ is required. Found $versionText" }
-
-Push-Location $repoRoot
-try {
-    Write-InstallStep "📦" "Installing shrinker from: $repoRoot"
-    if (-not $SkipNpmInstall) {
-        Write-InstallStep "📥" "Installing dependencies..."
-        & npm install --silent
-        if ($LASTEXITCODE -ne 0) { throw "npm install failed." }
-    }
-    if (-not $SkipBuild) {
-        Write-InstallStep "🏗️" "Building shrinker..."
-        & npm run build --silent
-        if ($LASTEXITCODE -ne 0) { throw "npm run build failed." }
-    }
-    if (-not $SkipLink) {
-        Write-InstallStep "🔗" "Linking shrinker globally..."
-        & npm link --silent
-        if ($LASTEXITCODE -ne 0) { throw "npm link failed." }
-    }
-} finally { Pop-Location }
-
-if (-not $SkipProfile -and $EnableProfileRouting) { Add-ProfileIntegration $ProfilePath $integrationPath }
-if (-not $SkipAgentRules) { Set-AgentRules $rulesBody }
-Write-InstallStep "✅" "Install complete."
-Write-Host " "
-Write-Host "💡 Try: shrinker help"
+param(
+    [switch]$Local,
+    [string]$PackageName = "shrinker-ai",
+    [string]$Registry = "https://registry.npmjs.org",
+    [string]$Version,
+    [switch]$SkipNpmInstall,
+    [switch]$SkipBuild,
+    [switch]$SkipLink,
+    [switch]$EnableProfileRouting,
+    [switch]$SkipProfile,
+    [switch]$SkipAgentRules,
+    [switch]$CopilotOnly,
+    [switch]$ClaudeOnly,
+    [switch]$EnableUncoveredTracking,
+    [switch]$DisableUncoveredTracking,
+    [string]$ProfilePath = $PROFILE,
+    [string]$ConfigPath = $(if ($env:SHRINKER_CONFIG_PATH) { $env:SHRINKER_CONFIG_PATH } else { Join-Path $HOME ".shrinker/config" }),
+    [int]$StepOffset = 0
+)
+
+$ErrorActionPreference = "Stop"
+$InstallStep = $StepOffset
+
+function Write-InstallStep {
+    param([string]$Emoji, [string]$Message)
+    $script:InstallStep++
+    Write-Host "$($script:InstallStep). $Emoji $Message"
+}
+
+if ($EnableProfileRouting -and $SkipProfile) { throw "Use either -EnableProfileRouting or -SkipProfile, not both." }
+if ($CopilotOnly -and $ClaudeOnly) { throw "Use either -CopilotOnly or -ClaudeOnly, not both." }
+if ($EnableUncoveredTracking -and $DisableUncoveredTracking) { throw "Use either -EnableUncoveredTracking or -DisableUncoveredTracking, not both." }
+
+# Prompt only on a real console; non-interactive installs keep tracking on and leave the profile alone.
+$IsInteractive = -not [System.Console]::IsInputRedirected -and $Host.UI.RawUI -ne $null
+
+function Read-YesNo {
+    param([string]$Question, [bool]$Default)
+    $hint = if ($Default) { "[Y/n]" } else { "[y/N]" }
+    $reply = (Read-Host "   $Question $hint").Trim().ToLowerInvariant()
+    switch ($reply) {
+        { $_ -in @("y", "yes") } { return $true }
+        { $_ -in @("n", "no") } { return $false }
+        default { return $Default }
+    }
+}
+
+if ($EnableUncoveredTracking) { $TrackUncovered = $true }
+elseif ($DisableUncoveredTracking) { $TrackUncovered = $false }
+elseif ($IsInteractive) {
+    Write-InstallStep "❓" "Track uncovered commands? Records which unfiltered commands cost the most tokens."
+    $TrackUncovered = Read-YesNo "Enable uncovered-command tracking?" $true
+}
+else { $TrackUncovered = $true }
+
+if ($IsInteractive -and -not $SkipProfile -and -not $EnableProfileRouting) {
+    Write-InstallStep "❓" "Route wrapped commands through shrinker automatically? Adds a line to $ProfilePath."
+    $EnableProfileRouting = Read-YesNo "Enable automatic shell routing?" $false
+}
+
+function Set-ConfigValue {
+    param([string]$Key, [string]$Value)
+    $directory = Split-Path -Parent $ConfigPath
+    if ($directory -and -not (Test-Path -LiteralPath $directory)) { New-Item -ItemType Directory -Force -Path $directory | Out-Null }
+    $lines = @()
+    if (Test-Path -LiteralPath $ConfigPath) {
+        $lines = @(Get-Content -LiteralPath $ConfigPath | Where-Object { $_ -notmatch "^\s*$Key\s*=" })
+    }
+    $lines += "$Key=$Value"
+    Set-Content -LiteralPath $ConfigPath -Value $lines -Encoding utf8
+    Write-InstallStep "⚙️" "Set $Key=$Value in: $ConfigPath"
+}
+
+function Set-AgentRules {
+    param([string]$Body)
+    $start = "<!-- shrinker agent rules start -->"
+    $end = "<!-- shrinker agent rules end -->"
+    foreach ($target in @((Join-Path $HOME ".copilot\copilot-instructions.md"), (Join-Path $HOME ".claude\CLAUDE.md"))) {
+        if ($ClaudeOnly -and $target.EndsWith(".copilot-instructions.md")) { continue }
+        if ($CopilotOnly -and $target.EndsWith("CLAUDE.md")) { continue }
+        New-Item -ItemType Directory -Path (Split-Path $target) -Force | Out-Null
+        $content = if (Test-Path $target) { Get-Content $target -Raw } else { "" }
+        $block = "$start`n$Body`n$end"
+        if ($null -ne $content -and $content.Contains($start) -and $content.Contains($end)) {
+            $content = [regex]::Replace($content, [regex]::Escape($start) + ".*?" + [regex]::Escape($end), $block, 'Singleline')
+            Set-Content $target $content
+        } elseif ($content) { Add-Content $target "`n$block`n" }
+        else { Set-Content $target "$block`n" }
+        Write-InstallStep "📄" "Installed managed rules in: $target"
+    }
+}
+
+function Add-ProfileIntegration {
+    param([string]$ProfileFile, [string]$IntegrationFile)
+    if (-not (Test-Path $ProfileFile)) { New-Item -ItemType File -Path $ProfileFile -Force | Out-Null }
+    $start = "# >>> shrinker integration >>>"
+    if ((Get-Content $ProfileFile -Raw).Contains($start)) { return }
+    Add-Content $ProfileFile "`n$start`n. `"$IntegrationFile`"`n# <<< shrinker integration <<<`n"
+    Write-InstallStep "🔧" "Added shrinker integration block to profile: $ProfileFile"
+}
+
+if (-not $Local) {
+    $packageSpec = if ($Version) { "$PackageName@$Version" } else { $PackageName }
+    Write-InstallStep "📦" "Installing $packageSpec from $Registry..."
+    & npm install --silent --global $packageSpec "--registry=$Registry"
+    if ($LASTEXITCODE -ne 0) { throw "npm package installation failed." }
+    Write-InstallStep "🔎" "Locating the installed package..."
+    $globalRoot = (& npm root --global).Trim()
+    if (-not $globalRoot) { throw "Could not determine the global npm package directory." }
+    $packageRoot = Join-Path $globalRoot ($PackageName -replace '/', '\')
+    $entrypoint = Join-Path $packageRoot "integrations\windows\install.ps1"
+    if (-not (Test-Path $entrypoint)) { throw "Installed package installer not found: $entrypoint" }
+    Write-InstallStep "⚙️" "Configuring the installed package..."
+    & pwsh -ExecutionPolicy Bypass -File $entrypoint -Local -SkipNpmInstall -SkipBuild -SkipLink -EnableProfileRouting:$EnableProfileRouting -SkipProfile:$SkipProfile -SkipAgentRules:$SkipAgentRules -CopilotOnly:$CopilotOnly -ClaudeOnly:$ClaudeOnly -EnableUncoveredTracking:$TrackUncovered -DisableUncoveredTracking:(-not $TrackUncovered) -ProfilePath $ProfilePath -ConfigPath $ConfigPath -StepOffset $InstallStep
+    if ($LASTEXITCODE -ne 0) { throw "Repository installer failed with exit code $LASTEXITCODE" }
+    return
+}
+
+$scriptDir = $PSScriptRoot
+$repoRoot = (Resolve-Path (Join-Path $scriptDir "..\..")).Path
+$templatePath = Join-Path $repoRoot "templates\agent-rules.md"
+$integrationPath = (Resolve-Path (Join-Path $scriptDir "shrinker-profile.ps1")).Path
+if (-not $SkipAgentRules) {
+    if (-not (Test-Path $templatePath)) { throw "Agent rules template not found: $templatePath" }
+    $rulesBody = Get-Content $templatePath -Raw
+}
+
+$versionText = & node -v 2>$null
+if (-not $versionText) { throw "Node.js was not found on PATH. Install Node.js 22.13+ first." }
+$version = [version]($versionText.TrimStart('v'))
+if ($version -lt [version]'22.13.0') { throw "Node.js 22.13+ is required. Found $versionText" }
+
+Push-Location $repoRoot
+try {
+    Write-InstallStep "📦" "Installing shrinker from: $repoRoot"
+    if (-not $SkipNpmInstall) {
+        Write-InstallStep "📥" "Installing dependencies..."
+        & npm install --silent
+        if ($LASTEXITCODE -ne 0) { throw "npm install failed." }
+    }
+    if (-not $SkipBuild) {
+        Write-InstallStep "🏗️" "Building shrinker..."
+        $previousQuiet = $env:SHRINKER_BUILD_QUIET
+        $env:SHRINKER_BUILD_QUIET = "1"
+        try { & npm run build --silent }
+        finally { $env:SHRINKER_BUILD_QUIET = $previousQuiet }
+        if ($LASTEXITCODE -ne 0) { throw "npm run build failed." }
+    }
+    if (-not $SkipLink) {
+        Write-InstallStep "🔗" "Linking shrinker globally..."
+        & npm link --silent
+        if ($LASTEXITCODE -ne 0) { throw "npm link failed." }
+    }
+} finally { Pop-Location }
+
+Set-ConfigValue "SHRINKER_TRACK_UNCOVERED" $(if ($TrackUncovered) { "1" } else { "0" })
+if (-not $SkipProfile -and $EnableProfileRouting) { Add-ProfileIntegration $ProfilePath $integrationPath }
+if (-not $SkipAgentRules) { Set-AgentRules $rulesBody }
+Write-InstallStep "✅" "Install complete."
+Write-Host " "
+Write-Host "💡 Try: shrinker help"

package/integrations/windows/shrinker-profile.ps1

@@ -1,136 +1,206 @@
-$global:ShrinkPowerShellRules = @{
-    git = @("status", "diff", "log", "show", "reflog", "branch", "tag", "stash")
-    npm = @("test", "t", "install", "i", "ci", "ls", "list")
-    docker = @("ps", "logs", "images", "compose")
-    kubectl = @("get", "describe", "logs")
-    gh = @("pr", "issue", "run")
-    rg = @("*")
-    find = @("*")
-    tail = @("*")
-    cat = @("*")
-    ls = @("*")
-    dir = @("*")
-}
-
-$global:ShrinkOptionValueFlags = @{
-    git = @("-C", "-c", "--git-dir", "--work-tree", "--namespace")
-    npm = @("--prefix", "--cache", "--registry", "--workspace", "--userconfig", "-w", "-C")
-    docker = @("-H", "--host", "--context", "--config")
-    kubectl = @("-n", "--namespace", "-o", "--output", "--context", "--kubeconfig", "--cluster", "--user")
-    gh = @("-R", "--repo")
-}
-
-$global:ShrinkNativePaths = @{}
-foreach ($name in @("git", "npm", "docker", "kubectl", "gh", "rg", "find", "tail")) {
-    $command = Get-Command $name -CommandType Application -ErrorAction SilentlyContinue | Select-Object -First 1
-    if ($command) {
-        $global:ShrinkNativePaths[$name] = $command.Source
-    }
-}
-
-function Get-ShrinkSubcommand {
-    param(
-        [string]$CommandName,
-        [object[]]$Arguments
-    )
-
-    $valueFlags = @($global:ShrinkOptionValueFlags[$CommandName])
-    for ($i = 0; $i -lt $Arguments.Count; $i += 1) {
-        $part = [string]$Arguments[$i]
-        if (-not $part) { continue }
-        if ($valueFlags -contains $part) {
-            $i += 1
-            continue
-        }
-        if ($part.StartsWith("-")) { continue }
-        return $part.ToLowerInvariant()
-    }
-
-    return ""
-}
-
-function Use-ShrinkRouting {
-    param(
-        [string]$CommandName,
-        [object[]]$Arguments
-    )
-
-    $allowlist = @($global:ShrinkPowerShellRules[$CommandName])
-    if ($allowlist.Count -eq 0) {
-        return $false
-    }
-    if ($allowlist -contains "*") {
-        return $true
-    }
-
-    $subcommand = Get-ShrinkSubcommand -CommandName $CommandName -Arguments $Arguments
-    return $allowlist -contains $subcommand
-}
-
-function Get-ShrinkCommandPath {
-    $candidates = Get-Command shrinker -All -ErrorAction SilentlyContinue
-    if (-not $candidates) {
-        return $null
-    }
-
-    foreach ($candidate in $candidates) {
-        $source = [string]$candidate.Source
-        if ($source -and $source.ToLowerInvariant().EndsWith(".cmd")) {
-            return $source
-        }
-    }
-    foreach ($candidate in $candidates) {
-        $source = [string]$candidate.Source
-        if ($source -and $source.ToLowerInvariant().EndsWith(".exe")) {
-            return $source
-        }
-    }
-    foreach ($candidate in $candidates) {
-        $source = [string]$candidate.Source
-        if ($source -and $source.ToLowerInvariant().EndsWith(".ps1")) {
-            return $source
-        }
-    }
-
-    return [string]($candidates | Select-Object -First 1).Source
-}
-
-function Invoke-ShrinkOrNative {
-    param(
-        [string]$CommandName,
-        [object[]]$Arguments
-    )
-
-    $routeToShrink = Use-ShrinkRouting -CommandName $CommandName -Arguments $Arguments
-    $shrinkCommand = Get-ShrinkCommandPath
-
-    if ($routeToShrink -and $shrinkCommand) {
-        & $shrinkCommand $CommandName @Arguments
-        return
-    }
-
-    $nativePath = $global:ShrinkNativePaths[$CommandName]
-    if ($nativePath) {
-        & $nativePath @Arguments
-        return
-    }
-
-    switch ($CommandName) {
-        "cat" { Microsoft.PowerShell.Management\Get-Content @Arguments; return }
-        "ls" { Microsoft.PowerShell.Management\Get-ChildItem @Arguments; return }
-        "dir" { Microsoft.PowerShell.Management\Get-ChildItem @Arguments; return }
-        default { throw "No native fallback found for '$CommandName'." }
-    }
-}
-
-function global:git { Invoke-ShrinkOrNative -CommandName "git" -Arguments $args }
-function global:npm { Invoke-ShrinkOrNative -CommandName "npm" -Arguments $args }
-function global:docker { Invoke-ShrinkOrNative -CommandName "docker" -Arguments $args }
-function global:kubectl { Invoke-ShrinkOrNative -CommandName "kubectl" -Arguments $args }
-function global:gh { Invoke-ShrinkOrNative -CommandName "gh" -Arguments $args }
-function global:rg { Invoke-ShrinkOrNative -CommandName "rg" -Arguments $args }
-function global:find { Invoke-ShrinkOrNative -CommandName "find" -Arguments $args }
-function global:tail { Invoke-ShrinkOrNative -CommandName "tail" -Arguments $args }
-function global:cat { Invoke-ShrinkOrNative -CommandName "cat" -Arguments $args }
-function global:ls { Invoke-ShrinkOrNative -CommandName "ls" -Arguments $args }
-function global:dir { Invoke-ShrinkOrNative -CommandName "dir" -Arguments $args }
+$global:ShrinkPowerShellRules = @{
+    git = @("status", "diff", "log", "show", "reflog", "branch", "tag", "stash")
+    npm = @("test", "t", "install", "i", "ci", "ls", "list")
+    docker = @("ps", "logs", "images", "compose")
+    kubectl = @("get", "describe", "logs")
+    gh = @("pr", "issue", "run")
+    rg = @("*")
+    find = @("*")
+    tail = @("*")
+    cat = @("*")
+    ls = @("*")
+    dir = @("*")
+}
+
+$global:ShrinkOptionValueFlags = @{
+    git = @("-C", "-c", "--git-dir", "--work-tree", "--namespace")
+    npm = @("--prefix", "--cache", "--registry", "--workspace", "--userconfig", "-w", "-C")
+    docker = @("-H", "--host", "--context", "--config")
+    kubectl = @("-n", "--namespace", "-o", "--output", "--context", "--kubeconfig", "--cluster", "--user")
+    gh = @("-R", "--repo")
+}
+
+$global:ShrinkNativePaths = @{}
+foreach ($name in @("git", "npm", "docker", "kubectl", "gh", "rg", "find", "tail")) {
+    $command = Get-Command $name -CommandType Application -ErrorAction SilentlyContinue | Select-Object -First 1
+    if ($command) {
+        $global:ShrinkNativePaths[$name] = $command.Source
+    }
+}
+
+function Get-ShrinkSubcommand {
+    param(
+        [string]$CommandName,
+        [object[]]$Arguments
+    )
+
+    $valueFlags = @($global:ShrinkOptionValueFlags[$CommandName])
+    for ($i = 0; $i -lt $Arguments.Count; $i += 1) {
+        $part = [string]$Arguments[$i]
+        if (-not $part) { continue }
+        if ($valueFlags -contains $part) {
+            $i += 1
+            continue
+        }
+        if ($part.StartsWith("-")) { continue }
+        return $part.ToLowerInvariant()
+    }
+
+    return ""
+}
+
+function Use-ShrinkRouting {
+    param(
+        [string]$CommandName,
+        [object[]]$Arguments
+    )
+
+    $allowlist = @($global:ShrinkPowerShellRules[$CommandName])
+    if ($allowlist.Count -eq 0) {
+        return $false
+    }
+    if ($allowlist -contains "*") {
+        return $true
+    }
+
+    $subcommand = Get-ShrinkSubcommand -CommandName $CommandName -Arguments $Arguments
+    return $allowlist -contains $subcommand
+}
+
+function Get-ShrinkCommandPath {
+    $candidates = Get-Command shrinker -All -ErrorAction SilentlyContinue
+    if (-not $candidates) {
+        return $null
+    }
+
+    foreach ($candidate in $candidates) {
+        $source = [string]$candidate.Source
+        if ($source -and $source.ToLowerInvariant().EndsWith(".cmd")) {
+            return $source
+        }
+    }
+    foreach ($candidate in $candidates) {
+        $source = [string]$candidate.Source
+        if ($source -and $source.ToLowerInvariant().EndsWith(".exe")) {
+            return $source
+        }
+    }
+    foreach ($candidate in $candidates) {
+        $source = [string]$candidate.Source
+        if ($source -and $source.ToLowerInvariant().EndsWith(".ps1")) {
+            return $source
+        }
+    }
+
+    return [string]($candidates | Select-Object -First 1).Source
+}
+
+# Resolved once at load so wrapped commands never pay for reading the config file.
+$script:ShrinkTrackUncoveredDefault = ""
+$script:ShrinkConfigPath = if ($env:SHRINKER_CONFIG_PATH) { $env:SHRINKER_CONFIG_PATH } else { Join-Path $HOME ".shrinker/config" }
+if (Test-Path -LiteralPath $script:ShrinkConfigPath) {
+    foreach ($line in Get-Content -LiteralPath $script:ShrinkConfigPath) {
+        $stripped = ($line -split "#", 2)[0].Trim()
+        if ($stripped -match '^\s*SHRINKER_TRACK_UNCOVERED\s*=\s*(.*)$') {
+            $script:ShrinkTrackUncoveredDefault = $Matches[1].Trim()
+        }
+    }
+}
+
+function Test-ShrinkTrackingEnabled {
+    $value = [string]$env:SHRINKER_TRACK_UNCOVERED
+    if (-not $value) { $value = $script:ShrinkTrackUncoveredDefault }
+    if (-not $value) { return $false }
+    return @("1", "true", "yes") -contains $value.Trim().ToLowerInvariant()
+}
+
+function Write-ShrinkUncovered {
+    param(
+        [string]$CommandName,
+        [object[]]$Arguments,
+        [int]$Bytes,
+        [int]$ExitCode
+    )
+
+    if (-not (Test-ShrinkTrackingEnabled)) { return }
+    $shrinkCommand = Get-ShrinkCommandPath
+    if (-not $shrinkCommand) { return }
+
+    $trackArgs = @("track", "--executable", $CommandName, "--bytes", $Bytes, "--exit-code", $ExitCode)
+    $subcommand = Get-ShrinkSubcommand -CommandName $CommandName -Arguments $Arguments
+    if ($subcommand) {
+        $trackArgs += @("--subcommand", $subcommand)
+    }
+
+    try {
+        Start-Process -FilePath $shrinkCommand -ArgumentList $trackArgs -WindowStyle Hidden -ErrorAction SilentlyContinue | Out-Null
+    } catch {}
+}
+
+function Invoke-ShrinkNativeTracked {
+    param(
+        [scriptblock]$Invoke,
+        [string]$CommandName,
+        [object[]]$Arguments
+    )
+
+    if (-not (Test-ShrinkTrackingEnabled)) {
+        & $Invoke
+        return
+    }
+
+    # Only measure output volume when stdout is redirected (the agent case). Interactive
+    # consoles stream the native output untouched so paging and colours still work.
+    if (-not [Console]::IsOutputRedirected) {
+        & $Invoke
+        Write-ShrinkUncovered -CommandName $CommandName -Arguments $Arguments -Bytes 0 -ExitCode ([int]$LASTEXITCODE)
+        return
+    }
+
+    $output = & $Invoke | Out-String -Stream
+    $exitCode = [int]$LASTEXITCODE
+    $text = ($output -join [Environment]::NewLine)
+    $bytes = [System.Text.Encoding]::UTF8.GetByteCount($text)
+    $output | ForEach-Object { $_ }
+    Write-ShrinkUncovered -CommandName $CommandName -Arguments $Arguments -Bytes $bytes -ExitCode $exitCode
+}
+
+function Invoke-ShrinkOrNative {
+    param(
+        [string]$CommandName,
+        [object[]]$Arguments
+    )
+
+    $routeToShrink = Use-ShrinkRouting -CommandName $CommandName -Arguments $Arguments
+    $shrinkCommand = Get-ShrinkCommandPath
+
+    if ($routeToShrink -and $shrinkCommand) {
+        & $shrinkCommand $CommandName @Arguments
+        return
+    }
+
+    $nativePath = $global:ShrinkNativePaths[$CommandName]
+    if ($nativePath) {
+        Invoke-ShrinkNativeTracked -CommandName $CommandName -Arguments $Arguments -Invoke { & $nativePath @Arguments }
+        return
+    }
+
+    switch ($CommandName) {
+        "cat" { Invoke-ShrinkNativeTracked -CommandName $CommandName -Arguments $Arguments -Invoke { Microsoft.PowerShell.Management\Get-Content @Arguments }; return }
+        "ls" { Invoke-ShrinkNativeTracked -CommandName $CommandName -Arguments $Arguments -Invoke { Microsoft.PowerShell.Management\Get-ChildItem @Arguments }; return }
+        "dir" { Invoke-ShrinkNativeTracked -CommandName $CommandName -Arguments $Arguments -Invoke { Microsoft.PowerShell.Management\Get-ChildItem @Arguments }; return }
+        default { throw "No native fallback found for '$CommandName'." }
+    }
+}
+
+function global:git { Invoke-ShrinkOrNative -CommandName "git" -Arguments $args }
+function global:npm { Invoke-ShrinkOrNative -CommandName "npm" -Arguments $args }
+function global:docker { Invoke-ShrinkOrNative -CommandName "docker" -Arguments $args }
+function global:kubectl { Invoke-ShrinkOrNative -CommandName "kubectl" -Arguments $args }
+function global:gh { Invoke-ShrinkOrNative -CommandName "gh" -Arguments $args }
+function global:rg { Invoke-ShrinkOrNative -CommandName "rg" -Arguments $args }
+function global:find { Invoke-ShrinkOrNative -CommandName "find" -Arguments $args }
+function global:tail { Invoke-ShrinkOrNative -CommandName "tail" -Arguments $args }
+function global:cat { Invoke-ShrinkOrNative -CommandName "cat" -Arguments $args }
+function global:ls { Invoke-ShrinkOrNative -CommandName "ls" -Arguments $args }
+function global:dir { Invoke-ShrinkOrNative -CommandName "dir" -Arguments $args }