shrinker-ai 0.1.0

package/integrations/shrinker-profile.ps1

@@ -0,0 +1,136 @@
+$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 }

package/integrations/uninstall-shrinker.ps1

@@ -0,0 +1,79 @@
+param(
+    [switch]$SkipUnlink,
+    [switch]$SkipAgentRules,
+    [switch]$CopilotOnly,
+    [switch]$ClaudeOnly,
+    [string]$ProfilePath = $PROFILE
+)
+
+$ErrorActionPreference = "Stop"
+
+if ($CopilotOnly -and $ClaudeOnly) {
+    throw "Use either -CopilotOnly or -ClaudeOnly, not both."
+}
+
+$blockStart = "<!-- shrinker agent rules start -->"
+$blockEnd = "<!-- shrinker agent rules end -->"
+
+function Remove-AgentRules {
+    param([string]$Path)
+
+    if (-not (Test-Path $Path)) { return }
+    $content = Get-Content -Path $Path -Raw
+    if (-not ($content.Contains($blockStart) -and $content.Contains($blockEnd))) { return }
+    $pattern = [regex]::Escape($blockStart) + ".*?" + [regex]::Escape($blockEnd)
+    Set-Content -Path $Path -Value ([regex]::Replace($content, $pattern, "", [System.Text.RegularExpressions.RegexOptions]::Singleline).TrimEnd() + "`n")
+    Write-Host "Removed managed rules from: $Path"
+}
+
+function Remove-ProfileIntegration {
+    param([string]$ProfileFile)
+
+    if (-not (Test-Path $ProfileFile)) {
+        Write-Host "Profile not found: $ProfileFile"
+        return
+    }
+
+    $startMarker = "# >>> shrinker integration >>>"
+    $endMarker = "# <<< shrinker integration <<<"
+    $content = Get-Content -Path $ProfileFile -Raw
+    if ($null -eq $content -or $content.Length -eq 0) {
+        Write-Host "Profile is empty; nothing to remove."
+        return
+    }
+
+    $start = $content.IndexOf($startMarker)
+    if ($start -lt 0) {
+        Write-Host "No shrinker integration block found in profile."
+        return
+    }
+
+    $end = $content.IndexOf($endMarker, $start)
+    if ($end -lt 0) {
+        Write-Host "Integration block start found but end marker is missing; leaving profile unchanged."
+        return
+    }
+
+    $end += $endMarker.Length
+    $updated = $content.Remove($start, $end - $start)
+    Set-Content -Path $ProfileFile -Value $updated
+    Write-Host "Removed shrinker integration block from: $ProfileFile"
+}
+
+if (-not $SkipUnlink) {
+    Write-Host "Running npm unlink -g shrinker..."
+    & npm unlink -g shrinker
+    if ($LASTEXITCODE -ne 0) {
+        throw "npm unlink failed with exit code $LASTEXITCODE"
+    }
+}
+
+Remove-ProfileIntegration -ProfileFile $ProfilePath
+Write-Host "If this terminal previously loaded shrinker-profile.ps1, restart terminal or remove Function:git/Function:rg wrappers from current session."
+
+if (-not $SkipAgentRules) {
+    if (-not $ClaudeOnly) { Remove-AgentRules -Path (Join-Path (Get-Location).Path ".copilot-instructions.md") }
+    if (-not $CopilotOnly) { Remove-AgentRules -Path (Join-Path (Get-Location).Path "CLAUDE.md") }
+}
+
+Write-Host "Uninstall complete."

package/integrations/uninstall.ps1

@@ -0,0 +1,35 @@
+param(
+    [string]$PackageName = "shrinker-ai",
+    [string]$Registry = "https://registry.npmjs.org",
+    [switch]$SkipAgentRules,
+    [switch]$CopilotOnly,
+    [switch]$ClaudeOnly
+)
+
+$ErrorActionPreference = "Stop"
+
+if ($CopilotOnly -and $ClaudeOnly) {
+    throw "Use either -CopilotOnly or -ClaudeOnly, not both."
+}
+
+$globalRoot = (& npm root --global).Trim()
+$packageRoot = Join-Path $globalRoot ($PackageName -replace '/', '\')
+$localUninstaller = Join-Path $packageRoot "integrations\uninstall-shrinker.ps1"
+if (Test-Path $localUninstaller) {
+    $localArgs = @("-ExecutionPolicy", "Bypass", "-File", $localUninstaller, "-SkipUnlink")
+    if ($SkipAgentRules) { $localArgs += "-SkipAgentRules" }
+    if ($CopilotOnly) { $localArgs += "-CopilotOnly" }
+    if ($ClaudeOnly) { $localArgs += "-ClaudeOnly" }
+    & pwsh @localArgs
+    if ($LASTEXITCODE -ne 0) {
+        throw "Installed package integration failed with exit code $LASTEXITCODE"
+    }
+}
+
+Write-Host "Removing $PackageName..."
+& npm uninstall --global $PackageName "--registry=$Registry"
+if ($LASTEXITCODE -ne 0) {
+    throw "npm package removal failed with exit code $LASTEXITCODE"
+}
+
+Write-Host "Package uninstallation complete."

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "shrinker-ai",
+  "version": "0.1.0",
+  "description": "Local deterministic command-output shrinker for coding agents",
+  "type": "module",
+  "bin": {
+    "shrinker": "./dist/src/cli.js"
+  },
+  "scripts": {
+    "start": "tsc -w -p tsconfig.json",
+    "build": "tsc -p tsconfig.json",
+    "pack": "npm run build --silent && npm pack",
+    "test": "npm run build --silent && node --test \"dist/tests/*.test.js\"",
+    "demo": "npm run build --silent && node dist/demo/run-demo.js",
+    "install:local": "pwsh -ExecutionPolicy Bypass -File ./integrations/install-shrinker.ps1",
+    "uninstall:local": "pwsh -ExecutionPolicy Bypass -File ./integrations/uninstall-shrinker.ps1",
+    "install:package": "pwsh -ExecutionPolicy Bypass -File ./integrations/install.ps1",
+    "uninstall:package": "pwsh -ExecutionPolicy Bypass -File ./integrations/uninstall.ps1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.9.0"
+  },
+  "engines": {
+    "node": ">=22.13"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "license": "MIT"
+}

package/templates/agent-rules.md

@@ -0,0 +1,19 @@
+Use `shrinker` for high-volume terminal outputs to reduce tokens.
+
+Routing policy:
+- `git status|diff|log|show|reflog|branch|tag|stash` -> `shrinker git ...`
+- `npm test|t|install|i|ci|ls|list` -> `shrinker npm ...`
+- `docker ps|logs|images|compose` -> `shrinker docker ...`
+- `kubectl get|describe|logs` -> `shrinker kubectl ...`
+- `gh pr|issue|run` -> `shrinker gh ...`
+- `rg`, `find`, `tail`, `cat`, `ls`, `dir` -> `shrinker <command> ...`
+
+Bypass shrinker when:
+- command modifies remote state and output volume is already tiny
+- command requires interactive stdin
+- command explicitly needs `shrinker --raw`
+
+Examples:
+- `shrinker git log -n 20`
+- `shrinker rg "pattern" src`
+- `shrinker docker logs api --tail 500`