shrinker-ai 0.4.0 → 0.9.0

package/.gitattributes

@@ -0,0 +1 @@
+*.sh text eol=lf

package/README.md

@@ -16,7 +16,9 @@ this POC proves that a few conservative, deterministic filters can save useful c
 
 ## Quick start
 
-Requires Node.js 22.13 or newer. This is the first Node 22 release where the built-in SQLite module no longer requires an experimental flag.
+The recommended customer install downloads a standalone binary from GitHub Releases. It does not require npm registry access or a local Node.js installation.
+
+Contributor and npm-based installs still require Node.js 22.13 or newer. This is the first Node 22 release where the built-in SQLite module no longer requires an experimental flag.
 
 ### One-command install (macOS zsh)
 
@@ -24,17 +26,59 @@ Requires Node.js 22.13 or newer. This is the first Node 22 release where the bui
 curl -fsSL https://raw.githubusercontent.com/ivanduplenskikh/shrinker/main/integrations/macos/install.sh | bash
 ```
 
+To pin a version:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/ivanduplenskikh/shrinker/main/integrations/macos/install.sh | bash -s -- --version 0.4.0
+```
+
 ### One-command install (Windows PowerShell)
 
 ```powershell
 irm https://raw.githubusercontent.com/ivanduplenskikh/shrinker/main/integrations/windows/install.ps1 | iex
 ```
 
-### Install from npm package
+To pin a version:
+
+```powershell
+& ([scriptblock]::Create((irm https://raw.githubusercontent.com/ivanduplenskikh/shrinker/main/integrations/windows/install.ps1))) -Version 0.4.0
+```
+
+The installer downloads these anonymous GitHub Release assets by default:
+
+- `shrinker-win-x64.zip`
+- `shrinker-macos-arm64.tar.gz`
+- `shrinker-macos-x64.tar.gz`
+- `shrinker-linux-x64.tar.gz`
+
+Network allowlists need access to `raw.githubusercontent.com` for the installer script and `github.com/ivanduplenskikh/shrinker/releases/download/...` for release assets.
+
+### Update notices
+
+Shrinker checks GitHub Releases at most once every 24 hours and prints an update notice to stderr when a newer version is available. The check only requests release metadata from GitHub; command output, paths, stats, and machine identifiers are not sent.
+
+To disable update checks for one shell session:
+
+```powershell
+$env:SHRINKER_UPDATE_CHECK = "0"
+```
+
+Or set it in `~/.shrinker/config`:
+
+```text
+SHRINKER_UPDATE_CHECK=0
+```
+
+### Optional npm package install
+
+Use this only when npm registry access is available or preferred.
 
 Windows PowerShell:
 
 ```powershell
+pwsh -ExecutionPolicy Bypass -File .\integrations\windows\install.ps1 -UseNpm
+
+# Or manually:
 npm install --global shrinker-ai --registry=https://registry.npmjs.org
 $pkg = Join-Path ((npm root --global).Trim()) "shrinker-ai"
 pwsh -ExecutionPolicy Bypass -File (Join-Path $pkg "integrations\\windows\\install.ps1") -Local -SkipNpmInstall -SkipBuild -SkipLink
@@ -45,6 +89,9 @@ To enable automatic PowerShell routing, add `-EnableProfileRouting` to the final
 macOS zsh:
 
 ```bash
+bash ./integrations/macos/install.sh --use-npm
+
+# Or manually:
 npm install --global shrinker-ai --registry=https://registry.npmjs.org
 pkg="$(npm root --global)/shrinker-ai"
 bash "$pkg/integrations/macos/install.sh" --local --skip-npm-install --skip-build --skip-link --enable-profile-routing
@@ -75,7 +122,21 @@ The rules tell agents to prefer `shrinker <command>` for high-volume commands wh
 
 ### Uninstall
 
-If you installed from npm, remove the package first:
+GitHub Release binary install:
+
+Windows PowerShell:
+
+```powershell
+pwsh -ExecutionPolicy Bypass -File .\integrations\windows\uninstall.ps1
+```
+
+macOS zsh:
+
+```bash
+bash ./integrations/macos/uninstall.sh
+```
+
+If you installed from npm, use npm mode:
 
 ```bash
 npm uninstall --global shrinker-ai --registry=https://registry.npmjs.org

package/dist/src/cli.js

@@ -9,6 +9,8 @@ import { formatMeasurements, measure } from "./metrics/measure.js";
 import { serveStatsDashboard, startStatsDashboard, writeStatsDashboard } from "./metrics/dashboard.js";
 import { classifyWrappedRun, commandSignature, isCoverageTrackingEnabled } from "./metrics/coverage.js";
 import { defaultStatsPath, formatCoverage, formatStats, formatStatsChart, getStats, recordRun, recordUncovered, } from "./metrics/stats-store.js";
+import { checkForUpdate, formatUpdateNotice, markUpdateNoticeShown, wasUpdateNoticeShown } from "./updates/check.js";
+import { getCurrentVersion } from "./version.js";
 function usage() {
     return `Usage:
   shrinker <command> [args...]
@@ -297,10 +299,25 @@ async function render(rawOutput, options, durationMs, exitCode) {
         }
     }
 }
+async function maybeShowUpdateNotice() {
+    try {
+        const currentVersion = getCurrentVersion();
+        const result = await checkForUpdate(currentVersion ? { currentVersion } : {});
+        if (result.latestVersion && wasUpdateNoticeShown(result.latestVersion))
+            return;
+        const notice = formatUpdateNotice(result);
+        if (notice)
+            process.stderr.write(`${notice}\n`);
+        if (result.latestVersion && notice)
+            markUpdateNoticeShown(result.latestVersion);
+    }
+    catch { }
+}
 async function main() {
     const options = parseArgs(process.argv.slice(2));
     if (options.mode === "help") {
         process.stdout.write(`${usage()}\n`);
+        await maybeShowUpdateNotice();
         return;
     }
     if (options.mode === "stats") {
@@ -321,6 +338,7 @@ async function main() {
                 else {
                     process.stdout.write(`Dashboard server started at http://127.0.0.1:${options.dashboardPort} (PID ${dashboard.pid})\n`);
                 }
+                await maybeShowUpdateNotice();
             }
             return;
         }
@@ -332,6 +350,7 @@ async function main() {
                     ? formatStatsChart(summary)
                     : formatStats(summary);
         process.stdout.write(`${output}\n`);
+        await maybeShowUpdateNotice();
         return;
     }
     if (options.mode === "track") {
@@ -368,6 +387,7 @@ async function main() {
     if (options.mode === "pipe") {
         const input = await readStdin();
         await render(input, options);
+        await maybeShowUpdateNotice();
         return;
     }
     const [command, ...args] = options.command;
@@ -376,6 +396,8 @@ async function main() {
     const result = await runCommand(command, args);
     await render(result.combined, options, result.durationMs, result.exitCode);
     process.exitCode = result.exitCode;
+    if (result.exitCode === 0)
+        await maybeShowUpdateNotice();
 }
 main().catch((error) => {
     process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);

package/dist/src/config.js

@@ -1,4 +1,4 @@
-import { readFileSync } from "node:fs";
+import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
 export function defaultConfigPath() {
@@ -35,6 +35,28 @@ export function resolveSetting(key, configPath) {
         return fromEnvironment;
     return readConfig(configPath).get(key);
 }
+export function setConfigValue(key, value, configPath = defaultConfigPath()) {
+    const directory = path.dirname(configPath);
+    mkdirSync(directory, { recursive: true, mode: 0o700 });
+    let lines = [];
+    try {
+        lines = readFileSync(configPath, "utf8").split(/\r?\n/);
+    }
+    catch { }
+    let replaced = false;
+    const nextLines = lines.map((line) => {
+        const withoutComment = line.split("#")[0]?.trim() ?? "";
+        const separator = withoutComment.indexOf("=");
+        const existingKey = separator > 0 ? withoutComment.slice(0, separator).trim() : "";
+        if (existingKey !== key)
+            return line;
+        replaced = true;
+        return `${key}=${value}`;
+    }).filter((line, index, array) => line !== "" || index < array.length - 1);
+    if (!replaced)
+        nextLines.push(`${key}=${value}`);
+    writeFileSync(configPath, `${nextLines.join("\n")}\n`, "utf8");
+}
 export function isTruthy(value) {
     const normalized = value?.trim().toLowerCase();
     return normalized === "1" || normalized === "true" || normalized === "yes";

package/dist/src/metrics/dashboard.js

@@ -8,6 +8,12 @@ import { DASHBOARD_STATS_PLACEHOLDER, DASHBOARD_TEMPLATE_HTML } from "./dashboar
 const execFileAsync = promisify(execFile);
 // Identifies a running server as ours without depending on user-visible copy.
 const DASHBOARD_MARKER = 'name="generator" content="shrinker-dashboard"';
+function getCliRelaunchCommand(args) {
+    if (process.pkg || !process.argv[1]) {
+        return { command: process.execPath, args };
+    }
+    return { command: process.execPath, args: [process.argv[1], ...args] };
+}
 // Neutralizes `</script>` inside string fields so the payload cannot break out of the JSON block.
 function serializePayload(summary) {
     const payload = {
@@ -146,7 +152,8 @@ export async function startStatsDashboard(port = 4317, restart = false) {
         openStatsDashboard(url);
         return { pid: 0, reused: true, restarted: false };
     }
-    const child = spawn(process.execPath, [process.argv[1] ?? "", "stats", "--dashboard", "--dashboard-server", "--port", String(port)], { detached: true, stdio: "ignore" });
+    const command = getCliRelaunchCommand(["stats", "--dashboard", "--dashboard-server", "--port", String(port)]);
+    const child = spawn(command.command, command.args, { detached: true, stdio: "ignore" });
     child.unref();
     return { pid: child.pid ?? 0, reused: false, restarted };
 }

package/dist/src/updates/check.js

@@ -0,0 +1,144 @@
+import { defaultConfigPath, isTruthy, readConfig, resolveSetting, setConfigValue } from "../config.js";
+const DEFAULT_REPOSITORY = "ivanduplenskikh/shrinker";
+const DEFAULT_INTERVAL_HOURS = 24;
+const DEFAULT_TIMEOUT_MS = 750;
+const LAST_CHECK_KEY = "SHRINKER_LAST_UPDATE_CHECK";
+const LATEST_VERSION_KEY = "SHRINKER_LATEST_VERSION";
+const NOTICE_SHOWN_KEY = "SHRINKER_UPDATE_NOTICE_SHOWN";
+function normalizeVersion(value) {
+    const normalized = value?.trim().replace(/^v/, "");
+    return normalized && /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/.test(normalized) ? normalized : undefined;
+}
+function parseVersion(value) {
+    const normalized = normalizeVersion(value);
+    if (!normalized)
+        return undefined;
+    const [core, suffix] = normalized.split(/[-+]/, 2);
+    const parts = core?.split(".").map((part) => Number(part)) ?? [];
+    const major = parts[0];
+    const minor = parts[1];
+    const patch = parts[2];
+    if (!Number.isInteger(major) || !Number.isInteger(minor) || !Number.isInteger(patch))
+        return undefined;
+    const parsedMajor = major;
+    const parsedMinor = minor;
+    const parsedPatch = patch;
+    return {
+        major: parsedMajor,
+        minor: parsedMinor,
+        patch: parsedPatch,
+        ...(suffix ? { prerelease: suffix } : {}),
+    };
+}
+export function compareVersions(current, latest) {
+    const left = parseVersion(current);
+    const right = parseVersion(latest);
+    if (!left || !right)
+        return 0;
+    for (const key of ["major", "minor", "patch"]) {
+        if (left[key] < right[key])
+            return -1;
+        if (left[key] > right[key])
+            return 1;
+    }
+    if (left.prerelease && !right.prerelease)
+        return -1;
+    if (!left.prerelease && right.prerelease)
+        return 1;
+    if ((left.prerelease ?? "") < (right.prerelease ?? ""))
+        return -1;
+    if ((left.prerelease ?? "") > (right.prerelease ?? ""))
+        return 1;
+    return 0;
+}
+function updateChecksEnabled(configPath) {
+    const setting = resolveSetting("SHRINKER_UPDATE_CHECK", configPath);
+    if (setting === undefined)
+        return true;
+    return isTruthy(setting);
+}
+function intervalHours(configPath, fallback) {
+    const configured = Number(resolveSetting("SHRINKER_UPDATE_CHECK_INTERVAL_HOURS", configPath));
+    return Number.isFinite(configured) && configured >= 0 ? configured : fallback;
+}
+function cachedResult(currentVersion, latestVersion) {
+    const latest = normalizeVersion(latestVersion);
+    return {
+        updateAvailable: compareVersions(currentVersion, latest) < 0,
+        ...(currentVersion ? { currentVersion } : {}),
+        ...(latest ? { latestVersion: latest } : {}),
+        checked: false,
+    };
+}
+function isCacheFresh(config, now, maxAgeHours) {
+    const previous = Number(config.get(LAST_CHECK_KEY));
+    if (!Number.isFinite(previous) || previous <= 0)
+        return false;
+    return now - previous < maxAgeHours * 60 * 60 * 1000;
+}
+async function fetchLatestRelease(repository, timeoutMs, fetchImpl) {
+    const response = await fetchImpl(`https://api.github.com/repos/${repository}/releases/latest`, {
+        headers: { "Accept": "application/vnd.github+json", "User-Agent": "shrinker-update-check" },
+        signal: AbortSignal.timeout(timeoutMs),
+    });
+    if (!response.ok)
+        return undefined;
+    const body = await response.json();
+    const version = normalizeVersion(typeof body.tag_name === "string" ? body.tag_name : undefined);
+    if (!version)
+        return undefined;
+    return {
+        version,
+        ...(typeof body.html_url === "string" ? { releaseUrl: body.html_url } : {}),
+    };
+}
+export async function checkForUpdate(options = {}) {
+    const configPath = options.configPath ?? defaultConfigPath();
+    const currentVersion = normalizeVersion(options.currentVersion);
+    if (!currentVersion || !updateChecksEnabled(configPath)) {
+        return { updateAvailable: false, ...(currentVersion ? { currentVersion } : {}), checked: false };
+    }
+    const now = options.now ?? Date.now();
+    const config = readConfig(configPath);
+    const maxAgeHours = options.intervalHours ?? intervalHours(configPath, DEFAULT_INTERVAL_HOURS);
+    if (isCacheFresh(config, now, maxAgeHours)) {
+        return cachedResult(currentVersion, config.get(LATEST_VERSION_KEY));
+    }
+    try {
+        const latest = await fetchLatestRelease(options.repository ?? DEFAULT_REPOSITORY, options.timeoutMs ?? DEFAULT_TIMEOUT_MS, options.fetchImpl ?? fetch);
+        if (!latest?.version)
+            return { updateAvailable: false, currentVersion, checked: true };
+        setConfigValue(LAST_CHECK_KEY, String(now), configPath);
+        setConfigValue(LATEST_VERSION_KEY, latest.version, configPath);
+        return {
+            updateAvailable: compareVersions(currentVersion, latest.version) < 0,
+            currentVersion,
+            latestVersion: latest.version,
+            ...(latest.releaseUrl ? { releaseUrl: latest.releaseUrl } : {}),
+            checked: true,
+        };
+    }
+    catch {
+        return { updateAvailable: false, currentVersion, checked: true };
+    }
+}
+export function formatUpdateNotice(result) {
+    if (!result.updateAvailable || !result.currentVersion || !result.latestVersion)
+        return undefined;
+    const releaseUrl = result.releaseUrl ?? `https://github.com/${DEFAULT_REPOSITORY}/releases/latest`;
+    const installCommand = process.platform === "win32"
+        ? `& ([scriptblock]::Create((irm https://raw.githubusercontent.com/${DEFAULT_REPOSITORY}/main/integrations/windows/install.ps1))) -Version ${result.latestVersion}`
+        : `curl -fsSL https://raw.githubusercontent.com/${DEFAULT_REPOSITORY}/main/integrations/macos/install.sh | bash -s -- --version ${result.latestVersion}`;
+    return [
+        `[shrinker] Update available: ${result.currentVersion} -> ${result.latestVersion}`,
+        `[shrinker] Release: ${releaseUrl}`,
+        `[shrinker] Install: ${installCommand}`,
+    ].join("\n");
+}
+export function markUpdateNoticeShown(latestVersion, configPath = defaultConfigPath()) {
+    setConfigValue(NOTICE_SHOWN_KEY, latestVersion, configPath);
+}
+export function wasUpdateNoticeShown(latestVersion, configPath = defaultConfigPath()) {
+    return readConfig(configPath).get(NOTICE_SHOWN_KEY) === latestVersion;
+}
+//# sourceMappingURL=check.js.map

package/dist/src/version.js

@@ -0,0 +1,66 @@
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+const VERSION_PATTERN = /^\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?$/;
+let cachedVersion;
+export function isPackagedBinary() {
+    return Boolean(process.pkg);
+}
+function normalizeVersion(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const normalized = value.trim().replace(/^v/, "");
+    return VERSION_PATTERN.test(normalized) ? normalized : undefined;
+}
+function readVersionFile(filePath) {
+    try {
+        const metadata = JSON.parse(readFileSync(filePath, "utf8"));
+        return normalizeVersion(metadata.version);
+    }
+    catch {
+        return undefined;
+    }
+}
+function findPackageJsonVersion(startDirectory) {
+    let directory = startDirectory;
+    while (true) {
+        const packagePath = path.join(directory, "package.json");
+        const version = readVersionFile(packagePath);
+        if (version)
+            return version;
+        const parent = path.dirname(directory);
+        if (parent === directory)
+            return undefined;
+        directory = parent;
+    }
+}
+function findManifestVersion() {
+    const executableDirectory = path.dirname(process.execPath);
+    for (const candidate of [
+        path.join(executableDirectory, "..", "manifest.json"),
+        path.join(executableDirectory, "manifest.json"),
+        path.join(process.cwd(), "manifest.json"),
+    ]) {
+        const resolved = path.resolve(candidate);
+        if (!existsSync(resolved))
+            continue;
+        const version = readVersionFile(resolved);
+        if (version)
+            return version;
+    }
+    return undefined;
+}
+export function getCurrentVersion() {
+    if (cachedVersion)
+        return cachedVersion;
+    const manifestVersion = findManifestVersion();
+    if (manifestVersion) {
+        cachedVersion = manifestVersion;
+        return cachedVersion;
+    }
+    const moduleDirectory = path.dirname(fileURLToPath(import.meta.url));
+    cachedVersion = findPackageJsonVersion(moduleDirectory);
+    return cachedVersion;
+}
+//# sourceMappingURL=version.js.map

package/integrations/macos/install.sh

@@ -4,6 +4,9 @@ set -euo pipefail
 PACKAGE_NAME="shrinker-ai"
 REGISTRY="https://registry.npmjs.org"
 VERSION=""
+USE_NPM=0
+RELEASE_REPO="ivanduplenskikh/shrinker"
+ASSET_BASE_URL=""
 LOCAL=0
 SKIP_NPM_INSTALL=0
 SKIP_BUILD=0
@@ -16,6 +19,7 @@ CLAUDE_ONLY=0
 TRACK_UNCOVERED=""
 PROFILE_PATH="${PROFILE_PATH:-$HOME/.zshrc}"
 CONFIG_PATH="${SHRINKER_CONFIG_PATH:-$HOME/.shrinker/config}"
+INSTALL_DIR="${SHRINKER_INSTALL_DIR:-$HOME/.shrinker}"
 STEP="${SHRINKER_STEP_OFFSET:-0}"
 
 print_message() {
@@ -28,9 +32,13 @@ print_message() {
 while [[ $# -gt 0 ]]; do
   case "$1" in
     --local) LOCAL=1 ;;
+    --use-npm) USE_NPM=1 ;;
     --package-name) PACKAGE_NAME="${2:-}"; shift ;;
     --registry) REGISTRY="${2:-}"; shift ;;
     --version) VERSION="${2:-}"; shift ;;
+    --release-repo) RELEASE_REPO="${2:-}"; shift ;;
+    --asset-base-url) ASSET_BASE_URL="${2:-}"; shift ;;
+    --install-dir) INSTALL_DIR="${2:-}"; shift ;;
     --skip-npm-install) SKIP_NPM_INSTALL=1 ;;
     --skip-build) SKIP_BUILD=1 ;;
     --skip-link) SKIP_LINK=1 ;;
@@ -83,7 +91,7 @@ if (( interactive && SKIP_PROFILE == 0 && ENABLE_PROFILE_ROUTING == 0 )); then
   ENABLE_PROFILE_ROUTING="$(prompt_yes_no "Enable automatic shell routing?" 0)"
 fi
 
-if (( LOCAL == 0 )); then
+if (( LOCAL == 0 && USE_NPM == 1 )); then
   package_spec="$PACKAGE_NAME"
   [[ -z "$VERSION" ]] || package_spec="$PACKAGE_NAME@$VERSION"
   print_message "📦" "Installing $package_spec from $REGISTRY..."
@@ -112,11 +120,13 @@ INTEGRATION_PATH="$SCRIPT_DIR/shrinker-profile.zsh"
 BLOCK_START="<!-- shrinker agent rules start -->"
 BLOCK_END="<!-- shrinker agent rules end -->"
 
-node_version_raw="$(node -v 2>/dev/null || true)"
-[[ -n "$node_version_raw" ]] || { print_message "❌" "Node.js was not found on PATH. Install Node.js 22.13+ first." >&2; exit 1; }
-node_version="${node_version_raw#v}"
-IFS='.' read -r node_major node_minor _ <<< "$node_version"
-(( node_major > 22 || (node_major == 22 && node_minor >= 13) )) || { print_message "❌" "Node.js 22.13+ is required. Found $node_version_raw" >&2; exit 1; }
+if (( LOCAL == 1 )); then
+  node_version_raw="$(node -v 2>/dev/null || true)"
+  [[ -n "$node_version_raw" ]] || { print_message "❌" "Node.js was not found on PATH. Install Node.js 22.13+ first." >&2; exit 1; }
+  node_version="${node_version_raw#v}"
+  IFS='.' read -r node_major node_minor _ <<< "$node_version"
+  (( node_major > 22 || (node_major == 22 && node_minor >= 13) )) || { print_message "❌" "Node.js 22.13+ is required. Found $node_version_raw" >&2; exit 1; }
+fi
 
 set_agent_rules() {
   local target="$1"
@@ -161,6 +171,19 @@ add_profile_integration() {
   fi
 }
 
+add_path_integration() {
+  local profile_file="$1"
+  mkdir -p "$(dirname "$profile_file")"; touch "$profile_file"
+  if ! grep -Fq '# >>> shrinker path >>>' "$profile_file"; then
+    printf '\n# >>> shrinker path >>>\nexport PATH="%s/bin:$PATH"\n# <<< shrinker path <<<\n\n' "$INSTALL_DIR" >> "$profile_file"
+    print_message "🧭" "Added shrinker to PATH in profile: $profile_file"
+  fi
+  case ":$PATH:" in
+    *":$INSTALL_DIR/bin:"*) ;;
+    *) export PATH="$INSTALL_DIR/bin:$PATH" ;;
+  esac
+}
+
 set_config_value() {
   local key="$1"
   local value="$2"
@@ -175,6 +198,73 @@ set_config_value() {
   print_message "⚙️" "Set $key=$value in: $CONFIG_PATH"
 }
 
+release_target() {
+  case "$(uname -s)-$(uname -m)" in
+    Darwin-arm64) printf '%s' "macos-arm64" ;;
+    Darwin-x86_64) printf '%s' "macos-x64" ;;
+    Linux-x86_64) printf '%s' "linux-x64" ;;
+    *) print_message "❌" "Unsupported release platform: $(uname -s)-$(uname -m)" >&2; exit 1 ;;
+  esac
+}
+
+release_asset_url() {
+  local target asset tag
+  target="$(release_target)"
+  asset="shrinker-$target.tar.gz"
+  if [[ -n "$ASSET_BASE_URL" ]]; then
+    printf '%s/%s' "${ASSET_BASE_URL%/}" "$asset"
+  elif [[ -n "$VERSION" ]]; then
+    tag="$VERSION"
+    [[ "$tag" == v* ]] || tag="v$tag"
+    printf 'https://github.com/%s/releases/download/%s/%s' "$RELEASE_REPO" "$tag" "$asset"
+  else
+    printf 'https://github.com/%s/releases/latest/download/%s' "$RELEASE_REPO" "$asset"
+  fi
+}
+
+install_release_package() {
+  local asset_url archive extract_dir name
+  asset_url="$(release_asset_url)"
+  archive="$(mktemp -t shrinker-release.XXXXXX).tar.gz"
+  extract_dir="$(mktemp -d -t shrinker-install.XXXXXX)"
+  trap 'rm -f "$archive"; rm -rf "$extract_dir"' RETURN
+
+  print_message "📦" "Downloading shrinker from: $asset_url"
+  curl -fL "$asset_url" -o "$archive"
+  tar -xzf "$archive" -C "$extract_dir"
+  mkdir -p "$INSTALL_DIR"
+  for name in bin integrations templates; do
+    [[ -d "$extract_dir/$name" ]] || { print_message "❌" "Release archive is missing: $name" >&2; exit 1; }
+    rm -rf "$INSTALL_DIR/$name"
+    cp -R "$extract_dir/$name" "$INSTALL_DIR/"
+  done
+  [[ -f "$extract_dir/manifest.json" ]] && cp "$extract_dir/manifest.json" "$INSTALL_DIR/manifest.json"
+  [[ -x "$INSTALL_DIR/bin/shrinker" ]] || chmod +x "$INSTALL_DIR/bin/shrinker"
+  [[ -x "$INSTALL_DIR/bin/shrinker" ]] || { print_message "❌" "Installed executable not found: $INSTALL_DIR/bin/shrinker" >&2; exit 1; }
+
+  add_path_integration "$PROFILE_PATH"
+  set_config_value "SHRINKER_TRACK_UNCOVERED" "$TRACK_UNCOVERED"
+  if (( SKIP_PROFILE == 0 && ENABLE_PROFILE_ROUTING == 1 )); then add_profile_integration "$PROFILE_PATH"; fi
+  if (( SKIP_AGENT_RULES == 0 )); then
+    [[ -f "$INSTALL_DIR/templates/agent-rules.md" ]] || { print_message "❌" "Agent rules template not found: $INSTALL_DIR/templates/agent-rules.md" >&2; exit 1; }
+    rules_body="$(cat "$INSTALL_DIR/templates/agent-rules.md")"
+    (( CLAUDE_ONLY )) || set_agent_rules "$HOME/.copilot/copilot-instructions.md" "$rules_body"
+    (( COPILOT_ONLY )) || set_agent_rules "$HOME/.claude/CLAUDE.md" "$rules_body"
+  fi
+
+  print_message "✅" "Install complete."
+  echo ""
+  echo "💡 Try: shrinker help"
+}
+
+if (( LOCAL == 0 )); then
+  install_release_package
+  if [[ -n "${BASH_SOURCE[0]:-}" && "${BASH_SOURCE[0]}" != "$0" ]]; then
+    return 0
+  fi
+  exit 0
+fi
+
 print_message "📦" "Installing shrinker from: $REPO_ROOT"
 pushd "$REPO_ROOT" >/dev/null
 if (( SKIP_NPM_INSTALL == 0 )); then

package/integrations/macos/uninstall.sh

@@ -1,8 +1,9 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-INSTALL_DIR="${HOME}/.shrinker-src"
+INSTALL_DIR="${SHRINKER_INSTALL_DIR:-$HOME/.shrinker}"
 REMOVE_INSTALL_DIR=0
+USE_NPM=0
 SKIP_UNLINK=0
 SKIP_AGENT_RULES=0
 COPILOT_ONLY=0
@@ -22,6 +23,7 @@ print_step() {
 
 while [[ $# -gt 0 ]]; do
   case "$1" in
+    --use-npm) USE_NPM=1 ;;
     --skip-unlink) SKIP_UNLINK=1 ;;
     --skip-agent-rules) SKIP_AGENT_RULES=1 ;;
     --copilot-only) COPILOT_ONLY=1 ;;
@@ -54,6 +56,17 @@ remove_profile_integration() {
   mv "$profile_file.tmp" "$profile_file"
 }
 
+remove_path_integration() {
+  local profile_file="$1"
+  [[ -f "$profile_file" ]] || return 0
+  awk -v start='# >>> shrinker path >>>' -v end='# <<< shrinker path <<<' 'BEGIN{inblock=0} {if(index($0,start)>0){inblock=1;next} if(inblock&&index($0,end)>0){inblock=0;next} if(!inblock)print}' "$profile_file" > "$profile_file.tmp"
+  mv "$profile_file.tmp" "$profile_file"
+}
+
+remove_release_install() {
+  rm -rf "$INSTALL_DIR/bin" "$INSTALL_DIR/integrations" "$INSTALL_DIR/templates" "$INSTALL_DIR/manifest.json"
+}
+
 # The dashboard runs as a detached daemon, so unlinking the package never stops it.
 stop_dashboard_server() {
   local url="http://127.0.0.1:$DASHBOARD_PORT"
@@ -86,14 +99,18 @@ remove_managed_config() {
 print_step "🛑" "Stopping the dashboard server on port $DASHBOARD_PORT..."
 stop_dashboard_server
 
-if (( SKIP_UNLINK == 0 )); then
+if (( SKIP_UNLINK == 0 && USE_NPM == 1 )); then
   print_step "🔗" "Unlinking shrinker globally..."
   npm unlink --silent --global shrinker-ai
+elif (( SKIP_UNLINK == 0 )); then
+  print_step "🔗" "Removing release-installed shrinker files..."
+  remove_release_install
 else
-  print_step "⏭️" "Skipped global npm unlink."
+  print_step "⏭️" "Skipped unlink/removal."
 fi
 print_step "🔧" "Removing shell profile integration..."
 remove_profile_integration "$PROFILE_PATH"
+remove_path_integration "$PROFILE_PATH"
 if (( SKIP_AGENT_RULES == 0 )); then
   (( CLAUDE_ONLY )) || remove_agent_rules "$HOME/.copilot/copilot-instructions.md"
   (( COPILOT_ONLY )) || remove_agent_rules "$HOME/.claude/CLAUDE.md"

package/integrations/windows/install.ps1

@@ -1,8 +1,12 @@
 param(
     [switch]$Local,
+    [switch]$UseNpm,
     [string]$PackageName = "shrinker-ai",
     [string]$Registry = "https://registry.npmjs.org",
     [string]$Version,
+    [string]$ReleaseRepo = "ivanduplenskikh/shrinker",
+    [string]$AssetBaseUrl,
+    [string]$InstallDir = $(Join-Path $HOME ".shrinker"),
     [switch]$SkipNpmInstall,
     [switch]$SkipBuild,
     [switch]$SkipLink,
@@ -99,7 +103,82 @@ function Add-ProfileIntegration {
     Write-InstallStep "🔧" "Added shrinker integration block to profile: $ProfileFile"
 }
 
-if (-not $Local) {
+function Add-UserPathEntry {
+    param([string]$Directory)
+    $currentUserPath = [Environment]::GetEnvironmentVariable("Path", "User")
+    $entries = @($currentUserPath -split [IO.Path]::PathSeparator | Where-Object { $_ })
+    if ($entries -notcontains $Directory) {
+        $newPath = (@($entries) + $Directory) -join [IO.Path]::PathSeparator
+        [Environment]::SetEnvironmentVariable("Path", $newPath, "User")
+        Write-InstallStep "🧭" "Added shrinker to the user PATH: $Directory"
+    }
+    $processEntries = @($env:Path -split [IO.Path]::PathSeparator | Where-Object { $_ })
+    if ($processEntries -notcontains $Directory) {
+        $env:Path = (@($processEntries) + $Directory) -join [IO.Path]::PathSeparator
+    }
+}
+
+function Get-ReleaseAssetUrl {
+    $assetName = "shrinker-win-x64.zip"
+    if ($AssetBaseUrl) { return "$($AssetBaseUrl.TrimEnd('/'))/$assetName" }
+    if ($Version) {
+        $tag = if ($Version.StartsWith("v")) { $Version } else { "v$Version" }
+        return "https://github.com/$ReleaseRepo/releases/download/$tag/$assetName"
+    }
+    return "https://github.com/$ReleaseRepo/releases/latest/download/$assetName"
+}
+
+function Install-ReleasePackage {
+    $assetUrl = Get-ReleaseAssetUrl
+    $archivePath = Join-Path ([IO.Path]::GetTempPath()) "shrinker-win-x64.zip"
+    $extractPath = Join-Path ([IO.Path]::GetTempPath()) ("shrinker-install-" + [guid]::NewGuid().ToString("N"))
+    try {
+        Write-InstallStep "📦" "Downloading shrinker from: $assetUrl"
+        Invoke-WebRequest -Uri $assetUrl -OutFile $archivePath -UseBasicParsing
+        New-Item -ItemType Directory -Force -Path $extractPath | Out-Null
+        Expand-Archive -LiteralPath $archivePath -DestinationPath $extractPath -Force
+        New-Item -ItemType Directory -Force -Path $InstallDir | Out-Null
+
+        foreach ($name in @("bin", "integrations", "templates")) {
+            $source = Join-Path $extractPath $name
+            if (-not (Test-Path -LiteralPath $source)) { throw "Release archive is missing: $name" }
+            Copy-Item -LiteralPath $source -Destination $InstallDir -Recurse -Force
+        }
+        if (Test-Path -LiteralPath (Join-Path $extractPath "manifest.json")) {
+            Copy-Item -LiteralPath (Join-Path $extractPath "manifest.json") -Destination $InstallDir -Force
+        }
+    }
+    finally {
+        Remove-Item -LiteralPath $archivePath -Force -ErrorAction SilentlyContinue
+        Remove-Item -LiteralPath $extractPath -Recurse -Force -ErrorAction SilentlyContinue
+    }
+
+    $binPath = Join-Path $InstallDir "bin"
+    $exePath = Join-Path $binPath "shrinker.exe"
+    $legacyExePath = Join-Path $InstallDir "shrinker.exe"
+    if (-not (Test-Path -LiteralPath $exePath) -and (Test-Path -LiteralPath $legacyExePath)) {
+        New-Item -ItemType Directory -Force -Path $binPath | Out-Null
+        Move-Item -LiteralPath $legacyExePath -Destination $exePath -Force
+    }
+    if (-not (Test-Path -LiteralPath $exePath)) { throw "Installed executable not found: $exePath" }
+    Add-UserPathEntry $binPath
+
+    $templatePath = Join-Path $InstallDir "templates\agent-rules.md"
+    $integrationPath = Join-Path $InstallDir "integrations\windows\shrinker-profile.ps1"
+    if (-not $SkipAgentRules) {
+        if (-not (Test-Path $templatePath)) { throw "Agent rules template not found: $templatePath" }
+        $rulesBody = Get-Content $templatePath -Raw
+    }
+
+    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"
+}
+
+if (-not $Local -and $UseNpm) {
     $packageSpec = if ($Version) { "$PackageName@$Version" } else { $PackageName }
     Write-InstallStep "📦" "Installing $packageSpec from $Registry..."
     & npm install --silent --global $packageSpec "--registry=$Registry"
@@ -116,6 +195,11 @@ if (-not $Local) {
     return
 }
 
+if (-not $Local) {
+    Install-ReleasePackage
+    return
+}
+
 $scriptDir = $PSScriptRoot
 $repoRoot = (Resolve-Path (Join-Path $scriptDir "..\..")).Path
 $templatePath = Join-Path $repoRoot "templates\agent-rules.md"

package/integrations/windows/uninstall.ps1

@@ -1,10 +1,12 @@
 param(
+    [switch]$UseNpm,
     [switch]$SkipUnlink,
     [switch]$SkipAgentRules,
     [switch]$CopilotOnly,
     [switch]$ClaudeOnly,
     [switch]$PurgeData,
     [int]$Port = 4317,
+    [string]$InstallDir = $(Join-Path $HOME ".shrinker"),
     [string]$ProfilePath = $PROFILE,
     [string]$ConfigPath = $(if ($env:SHRINKER_CONFIG_PATH) { $env:SHRINKER_CONFIG_PATH } else { Join-Path $HOME ".shrinker/config" })
 )
@@ -45,6 +47,25 @@ function Remove-ProfileIntegration {
     }
 }
 
+function Remove-UserPathEntry {
+    param([string]$Directory)
+    $currentUserPath = [Environment]::GetEnvironmentVariable("Path", "User")
+    if (-not $currentUserPath) { return }
+    $entries = @($currentUserPath -split [IO.Path]::PathSeparator | Where-Object { $_ -and $_ -ne $Directory })
+    $newPath = $entries -join [IO.Path]::PathSeparator
+    if ($newPath -ne $currentUserPath) {
+        [Environment]::SetEnvironmentVariable("Path", $newPath, "User")
+        Write-UninstallStep "🧭" "Removed shrinker from the user PATH: $Directory"
+    }
+}
+
+function Remove-ReleaseInstall {
+    foreach ($name in @("bin", "integrations", "templates", "manifest.json")) {
+        Remove-Item -LiteralPath (Join-Path $InstallDir $name) -Recurse -Force -ErrorAction SilentlyContinue
+    }
+    Remove-UserPathEntry (Join-Path $InstallDir "bin")
+}
+
 # The dashboard runs as a detached daemon, so unlinking the package never stops it.
 function Stop-DashboardServer {
     param([int]$DashboardPort)
@@ -72,11 +93,15 @@ function Remove-ManagedConfig {
 Write-UninstallStep "🛑" "Stopping the dashboard server on port $Port..."
 Stop-DashboardServer $Port
 
-if (-not $SkipUnlink) {
+if (-not $SkipUnlink -and $UseNpm) {
     Write-UninstallStep "🔗" "Unlinking shrinker globally..."
     & npm unlink --silent --global shrinker-ai
     if ($LASTEXITCODE -ne 0) { throw "npm unlink failed." }
 }
+elseif (-not $SkipUnlink) {
+    Write-UninstallStep "🔗" "Removing release-installed shrinker files..."
+    Remove-ReleaseInstall
+}
 else { Write-UninstallStep "⏭️" "Skipped global npm unlink." }
 Write-UninstallStep "🔧" "Removing PowerShell profile integration..."
 Remove-ProfileIntegration $ProfilePath

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "shrinker-ai",
-  "version": "0.4.0",
+  "version": "0.9.0",
   "description": "Local deterministic command-output shrinker for coding agents",
   "type": "module",
   "bin": {
@@ -17,6 +17,8 @@
     "dashboard": "npm run build --silent && node dist/src/cli.js stats --dashboard",
     "dashboard:restart": "npm run build --silent && node dist/src/cli.js stats --dashboard --restart",
     "pack": "npm run build --silent && npm pack",
+    "package:release": "npm run build --silent && node scripts/package-release.mjs",
+    "package:release:current": "node scripts/package-release.mjs",
     "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/windows/install.ps1 -Local",
@@ -30,6 +32,7 @@
   },
   "devDependencies": {
     "@types/node": "^24.0.0",
+    "@yao-pkg/pkg": "^6.22.0",
     "typescript": "^5.9.0"
   },
   "engines": {

package/scripts/package-release.mjs

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+import { cp, mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+import path from "node:path";
+import process from "node:process";
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+const packageJson = JSON.parse(await readFile(path.join(repoRoot, "package.json"), "utf8"));
+
+const targets = {
+  "win-x64": { pkg: "node22-win-x64", archive: "zip", binary: "shrinker.exe" },
+  "macos-arm64": { pkg: "node22-macos-arm64", archive: "tar.gz", binary: "shrinker" },
+  "macos-x64": { pkg: "node22-macos-x64", archive: "tar.gz", binary: "shrinker" },
+  "linux-x64": { pkg: "node22-linux-x64", archive: "tar.gz", binary: "shrinker" },
+};
+
+function currentTarget() {
+  if (process.platform === "win32" && process.arch === "x64") return "win-x64";
+  if (process.platform === "darwin" && process.arch === "arm64") return "macos-arm64";
+  if (process.platform === "darwin" && process.arch === "x64") return "macos-x64";
+  if (process.platform === "linux" && process.arch === "x64") return "linux-x64";
+  throw new Error(`No default release target for ${process.platform}-${process.arch}. Pass --target explicitly.`);
+}
+
+function readOption(name) {
+  const index = process.argv.indexOf(name);
+  if (index === -1) return undefined;
+  const value = process.argv[index + 1];
+  if (!value || value.startsWith("--")) throw new Error(`${name} requires a value`);
+  return value;
+}
+
+function readTarget() {
+  const explicit = readOption("--target");
+  if (explicit) return explicit;
+  const positional = process.argv.slice(2).find((arg) => !arg.startsWith("--"));
+  return positional ?? currentTarget();
+}
+
+function run(command, args, options = {}) {
+  const result = spawnSync(command, args, {
+    cwd: repoRoot,
+    stdio: "inherit",
+    shell: false,
+    ...options,
+  });
+  if (result.status !== 0) {
+    throw new Error(`${command} ${args.join(" ")} failed with exit code ${result.status ?? "unknown"}`);
+  }
+}
+
+async function copySupportFiles(stageDir) {
+  await cp(
+    path.join(repoRoot, "integrations", "windows", "shrinker-profile.ps1"),
+    path.join(stageDir, "integrations", "windows", "shrinker-profile.ps1"),
+    { recursive: true },
+  );
+  await cp(
+    path.join(repoRoot, "integrations", "macos", "shrinker-profile.zsh"),
+    path.join(stageDir, "integrations", "macos", "shrinker-profile.zsh"),
+    { recursive: true },
+  );
+  await cp(
+    path.join(repoRoot, "templates", "agent-rules.md"),
+    path.join(stageDir, "templates", "agent-rules.md"),
+    { recursive: true },
+  );
+}
+
+async function createArchive(stageDir, archivePath, archiveType) {
+  await rm(archivePath, { force: true });
+  if (archiveType === "zip") {
+    const expression = [
+      "$ErrorActionPreference = 'Stop'",
+      `$source = Join-Path '${stageDir.replaceAll("'", "''")}' '*'`,
+      `Compress-Archive -Path $source -DestinationPath '${archivePath.replaceAll("'", "''")}' -Force`,
+    ].join("; ");
+    run("pwsh", ["-NoProfile", "-Command", expression]);
+    return;
+  }
+
+  run("tar", ["-czf", archivePath, "-C", stageDir, "."]);
+}
+
+const targetName = readTarget();
+const version = readOption("--version") ?? packageJson.version;
+const target = targets[targetName];
+if (!target) {
+  throw new Error(`Unsupported target '${targetName}'. Supported targets: ${Object.keys(targets).join(", ")}`);
+}
+
+const entrypoint = path.join(repoRoot, "dist", "src", "cli.js");
+if (!existsSync(entrypoint)) {
+  throw new Error("Missing dist/src/cli.js. Run npm run build before packaging.");
+}
+
+const releaseDir = path.join(repoRoot, "release");
+const stageDir = path.join(repoRoot, ".shrinker", "package", targetName);
+const binaryPath = path.join(stageDir, "bin", target.binary);
+const archiveName = `shrinker-${targetName}.${target.archive === "zip" ? "zip" : "tar.gz"}`;
+const archivePath = path.join(releaseDir, archiveName);
+
+await rm(stageDir, { recursive: true, force: true });
+await mkdir(path.dirname(binaryPath), { recursive: true });
+await mkdir(releaseDir, { recursive: true });
+
+run(process.execPath, [
+  path.join(repoRoot, "node_modules", "@yao-pkg", "pkg", "lib-es5", "bin.js"),
+  entrypoint,
+  "--targets",
+  target.pkg,
+  "--output",
+  binaryPath,
+  "--no-bytecode",
+  "--public",
+  "--public-packages",
+  "*",
+]);
+await copySupportFiles(stageDir);
+await writeFile(
+  path.join(stageDir, "manifest.json"),
+  `${JSON.stringify({ name: packageJson.name, version, target: targetName, binary: `bin/${target.binary}` }, null, 2)}\n`,
+  "utf8",
+);
+
+await createArchive(stageDir, archivePath, target.archive);
+console.log(`Created ${path.relative(repoRoot, archivePath)}`);