shrinker-ai 0.1.0

package/dist/src/filters/test-output.js

@@ -0,0 +1,54 @@
+import { cleanText } from "../formatting/ansi.js";
+import { limitLines } from "../formatting/limits.js";
+const IMPORTANT = /\b(fail(?:ed|ure|ing)?|error|exception|panic|expected|received|assert(?:ion)?|×|✕|not ok)\b/i;
+const SUMMARY = /\b(tests?|suites?|passed|failed|skipped|duration|time|snapshots?|collected)\b/i;
+const PASS_LINE = /^\s*(?:✓|✔|ok\b|pass(?:ed)?\b|\.{2,})/i;
+export function filterTestOutput(input, options) {
+    const lines = cleanText(input).split("\n");
+    const kept = [];
+    let passingLines = 0;
+    let inFailure = false;
+    let failureContext = 0;
+    for (const line of lines) {
+        if (IMPORTANT.test(line)) {
+            inFailure = true;
+            failureContext = 8;
+            kept.push(line);
+            continue;
+        }
+        if (inFailure && failureContext > 0) {
+            if (line.trim() || failureContext >= 6)
+                kept.push(line);
+            failureContext -= 1;
+            if (failureContext === 0)
+                inFailure = false;
+            continue;
+        }
+        if (PASS_LINE.test(line)) {
+            passingLines += 1;
+        }
+        else if (SUMMARY.test(line)) {
+            kept.push(line);
+        }
+    }
+    if (passingLines > 0) {
+        kept.unshift(`[${passingLines} passing-detail lines collapsed]`);
+    }
+    if (kept.length === 0) {
+        return {
+            output: lines.join("\n"),
+            kind: "test",
+            omitted: false,
+            notes: ["unrecognized test format; returned cleaned output"],
+        };
+    }
+    const deduplicated = kept.filter((line, index) => index === 0 || line !== kept[index - 1]);
+    const limited = limitLines(deduplicated, options.maxLines);
+    return {
+        output: limited.lines.join("\n"),
+        kind: "test",
+        omitted: passingLines > 0 || limited.omitted > 0 || kept.length < lines.length,
+        notes: passingLines > 0 ? [`collapsed ${passingLines} passing lines`] : [],
+    };
+}
+//# sourceMappingURL=test-output.js.map

package/dist/src/filters/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/formatting/ansi.js

@@ -0,0 +1,13 @@
+const ANSI_PATTERN = 
+// eslint-disable-next-line no-control-regex
+/[\u001B\u009B][[\]()#;?]*(?:(?:(?:[a-zA-Z\d]*(?:;[-a-zA-Z\d/#&.:=?%@~_]+)*)?\u0007)|(?:(?:\d{1,4}(?:[;:]\d{0,4})*)?[\dA-PR-TZcf-nq-uy=><~]))/g;
+export function cleanText(input) {
+    return input
+        .replace(ANSI_PATTERN, "")
+        .replace(/\r(?!\n)/g, "\n")
+        .replace(/\r\n/g, "\n")
+        .replace(/[ \t]+$/gm, "")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+//# sourceMappingURL=ansi.js.map

package/dist/src/formatting/limits.js

@@ -0,0 +1,17 @@
+export function limitLines(lines, maxLines) {
+    if (lines.length <= maxLines) {
+        return { lines, omitted: 0 };
+    }
+    const headCount = Math.ceil(maxLines * 0.65);
+    const tailCount = Math.max(1, maxLines - headCount);
+    const omitted = lines.length - headCount - tailCount;
+    return {
+        lines: [
+            ...lines.slice(0, headCount),
+            `... ${omitted} lines omitted ...`,
+            ...lines.slice(-tailCount),
+        ],
+        omitted,
+    };
+}
+//# sourceMappingURL=limits.js.map

package/dist/src/metrics/dashboard.js

@@ -0,0 +1,138 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { spawn } from "node:child_process";
+import path from "node:path";
+function escapeHtml(value) {
+    return value
+        .replaceAll("&", "&")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&#39;");
+}
+function formatInteger(value) {
+    return new Intl.NumberFormat("en-US").format(value);
+}
+function makeChart(summary) {
+    const width = 960;
+    const height = 420;
+    const left = 72;
+    const right = 28;
+    const top = 34;
+    const bottom = 62;
+    const plotWidth = width - left - right;
+    const plotHeight = height - top - bottom;
+    const maxSaved = Math.max(1, ...summary.daily.map((row) => row.estimatedTokensSaved));
+    const points = summary.daily.map((row, index) => {
+        const x = summary.daily.length === 1
+            ? left + plotWidth / 2
+            : left + (index / (summary.daily.length - 1)) * plotWidth;
+        const y = top + plotHeight - (row.estimatedTokensSaved / maxSaved) * plotHeight;
+        return { ...row, x, y };
+    });
+    const grid = Array.from({ length: 5 }, (_, index) => {
+        const value = Math.round((maxSaved * (4 - index)) / 4);
+        const y = top + (index / 4) * plotHeight;
+        return `<line class="grid" x1="${left}" y1="${y}" x2="${width - right}" y2="${y}" />` +
+            `<text class="axis-label" x="${left - 12}" y="${y + 4}" text-anchor="end">${formatInteger(value)}</text>`;
+    }).join("");
+    const labels = points.map((point, index) => {
+        if (summary.daily.length > 10 && index % Math.ceil(summary.daily.length / 8) !== 0 && index !== points.length - 1)
+            return "";
+        return `<text class="axis-label" x="${point.x}" y="${height - 28}" text-anchor="middle">${escapeHtml(point.date.slice(5))}</text>`;
+    }).join("");
+    const line = points.map((point) => `${point.x},${point.y}`).join(" ");
+    const dots = points.map((point) => `<circle class="point" cx="${point.x}" cy="${point.y}" r="4"><title>${escapeHtml(point.date)}: ${formatInteger(point.estimatedTokensSaved)} tokens saved, ${point.runs} runs</title></circle>`).join("");
+    if (points.length === 0) {
+        return `<div class="empty-chart">No recorded runs in the last 30 days.</div>`;
+    }
+    return `<svg viewBox="0 0 ${width} ${height}" role="img" aria-label="Daily estimated tokens saved over the last 30 days">
+    <text class="axis-title" x="18" y="${top + plotHeight / 2}" transform="rotate(-90 18 ${top + plotHeight / 2})">Tokens saved</text>
+    ${grid}
+    <line class="axis" x1="${left}" y1="${top + plotHeight}" x2="${width - right}" y2="${top + plotHeight}" />
+    <polyline class="trend" points="${line}" />
+    ${dots}
+    ${labels}
+    <text class="axis-title" x="${left + plotWidth / 2}" y="${height - 6}" text-anchor="middle">Date</text>
+  </svg>`;
+}
+export function defaultDashboardPath(databasePath) {
+    return path.join(path.dirname(databasePath), "dashboard.html");
+}
+export function writeStatsDashboard(summary, outputPath = defaultDashboardPath(summary.databasePath)) {
+    const filters = summary.byFilter.length === 0
+        ? `<p class="muted">No filter data yet.</p>`
+        : summary.byFilter.map((row) => `<div class="filter-row"><span>${escapeHtml(row.filterKind)}</span><strong>${formatInteger(row.estimatedTokensSaved)}</strong><small>${row.reductionPercent}% reduction</small></div>`).join("");
+    const html = `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Shrinker stats dashboard</title>
+<style>
+:root { color-scheme: light; --ink: #17202a; --muted: #66727f; --line: #dce3e8; --blue: #2774d9; --blue-soft: #eaf2ff; --green: #16856b; --surface: #ffffff; --background: #f4f7fa; }
+* { box-sizing: border-box; }
+body { margin: 0; color: var(--ink); background: var(--background); font: 15px/1.5 ui-sans-serif, system-ui, -apple-system, sans-serif; }
+main { max-width: 1180px; margin: 0 auto; padding: 42px 28px 56px; }
+.eyebrow { margin: 0 0 8px; color: var(--blue); font-size: 12px; font-weight: 800; letter-spacing: .12em; text-transform: uppercase; }
+h1 { margin: 0; font-size: clamp(28px, 4vw, 44px); letter-spacing: -.03em; }
+.subtitle { margin: 8px 0 30px; color: var(--muted); }
+.cards { display: grid; grid-template-columns: repeat(3, 1fr); gap: 14px; margin-bottom: 20px; }
+.card, .panel { border: 1px solid var(--line); border-radius: 8px; background: var(--surface); box-shadow: 0 8px 24px #26394d0d; }
+.card { padding: 18px 20px; }
+.card label { display: block; color: var(--muted); font-size: 12px; font-weight: 700; text-transform: uppercase; letter-spacing: .08em; }
+.card strong { display: block; margin-top: 6px; font-size: 27px; }
+.panel { padding: 22px; }
+.panel h2 { margin: 0 0 4px; font-size: 18px; }
+.panel p { margin: 0 0 14px; color: var(--muted); }
+.chart { overflow: hidden; }
+svg { display: block; width: 100%; min-width: 620px; height: auto; }
+.chart { overflow-x: auto; }
+.grid { stroke: var(--line); stroke-width: 1; }
+.axis { stroke: #9aa9b5; stroke-width: 1; }
+.axis-label, .axis-title { fill: var(--muted); font-size: 12px; }
+.trend { fill: none; stroke: var(--blue); stroke-width: 3; stroke-linecap: round; stroke-linejoin: round; }
+.point { fill: var(--surface); stroke: var(--blue); stroke-width: 3; }
+.point:hover { fill: var(--blue); r: 6; }
+.lower { display: grid; grid-template-columns: 1.2fr .8fr; gap: 20px; margin-top: 20px; }
+.filter-row { display: grid; grid-template-columns: 1fr auto auto; gap: 18px; align-items: baseline; padding: 11px 0; border-bottom: 1px solid var(--line); }
+.filter-row:last-child { border-bottom: 0; }
+.filter-row small { color: var(--green); }
+.muted { color: var(--muted); }
+@media (max-width: 720px) { main { padding: 28px 16px 40px; } .cards, .lower { grid-template-columns: 1fr; } .card strong { font-size: 24px; } }
+</style>
+</head>
+<body>
+<main>
+  <p class="eyebrow">Local activity</p>
+  <h1>Shrinker stats</h1>
+  <p class="subtitle">Token reduction over the last 30 days</p>
+  <section class="cards">
+    <div class="card"><label>All-time saved</label><strong>${formatInteger(summary.total.estimatedTokensSaved)}</strong></div>
+    <div class="card"><label>Runs this week</label><strong>${formatInteger(summary.last7Days.runs)}</strong></div>
+    <div class="card"><label>Average reduction</label><strong>${summary.total.reductionPercent}%</strong></div>
+  </section>
+  <section class="panel chart"><h2>Tokens saved over time</h2><p>Estimated savings from recorded command runs.</p>${makeChart(summary)}</section>
+  <section class="lower">
+    <section class="panel"><h2>By filter</h2><p>Where the savings come from.</p>${filters}</section>
+    <section class="panel"><h2>Storage</h2><p>Stats stay on this machine.</p><p class="muted">${escapeHtml(summary.databasePath)}</p></section>
+  </section>
+</main>
+</body>
+</html>
+`;
+    mkdirSync(path.dirname(outputPath), { recursive: true, mode: 0o700 });
+    writeFileSync(outputPath, html, "utf8");
+    return outputPath;
+}
+export function openStatsDashboard(outputPath) {
+    const platform = process.platform;
+    if (platform === "win32") {
+        const child = spawn("cmd.exe", ["/c", "start", "", outputPath], { detached: true, stdio: "ignore" });
+        child.unref();
+        return;
+    }
+    const command = platform === "darwin" ? "open" : "xdg-open";
+    const child = spawn(command, [outputPath], { detached: true, stdio: "ignore" });
+    child.unref();
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/src/metrics/measure.js

@@ -0,0 +1,29 @@
+function estimatedTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+export function measure(raw, output) {
+    const rawBytes = Buffer.byteLength(raw);
+    const outputBytes = Buffer.byteLength(output);
+    const rawEstimatedTokens = estimatedTokens(raw);
+    const outputEstimatedTokens = estimatedTokens(output);
+    const estimatedTokensSaved = Math.max(0, rawEstimatedTokens - outputEstimatedTokens);
+    const reductionPercent = rawEstimatedTokens === 0
+        ? 0
+        : Math.max(0, Math.round((1 - outputEstimatedTokens / rawEstimatedTokens) * 100));
+    return {
+        rawBytes,
+        outputBytes,
+        rawEstimatedTokens,
+        outputEstimatedTokens,
+        estimatedTokensSaved,
+        reductionPercent,
+    };
+}
+export function formatMeasurements(measurements, durationMs) {
+    const duration = durationMs === undefined ? "" : ` | ${durationMs}ms`;
+    const gain = measurements.estimatedTokensSaved > 0 && measurements.estimatedTokensSaved < 50
+        ? `${measurements.estimatedTokensSaved} saved, small absolute gain`
+        : `${measurements.estimatedTokensSaved} saved`;
+    return `[shrinker] ${measurements.rawBytes}B -> ${measurements.outputBytes}B | est. tokens ${measurements.rawEstimatedTokens} -> ${measurements.outputEstimatedTokens} (${gain}) | -${measurements.reductionPercent}%${duration}`;
+}
+//# sourceMappingURL=measure.js.map

package/dist/src/metrics/stats-store.js

@@ -0,0 +1,166 @@
+import { mkdirSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { DatabaseSync } from "node:sqlite";
+export function defaultStatsPath() {
+    return path.join(os.homedir(), ".shrinker", "stats.db");
+}
+function openDatabase(databasePath) {
+    mkdirSync(path.dirname(databasePath), { recursive: true, mode: 0o700 });
+    const database = new DatabaseSync(databasePath);
+    database.exec(`
+    PRAGMA journal_mode = WAL;
+    PRAGMA busy_timeout = 2000;
+    CREATE TABLE IF NOT EXISTS runs (
+      id INTEGER PRIMARY KEY,
+      created_at TEXT NOT NULL DEFAULT CURRENT_TIMESTAMP,
+      mode TEXT NOT NULL,
+      filter_kind TEXT NOT NULL,
+      command_name TEXT NOT NULL,
+      raw_bytes INTEGER NOT NULL,
+      output_bytes INTEGER NOT NULL,
+      raw_estimated_tokens INTEGER NOT NULL,
+      output_estimated_tokens INTEGER NOT NULL,
+      estimated_tokens_saved INTEGER NOT NULL,
+      reduction_percent INTEGER NOT NULL,
+      duration_ms INTEGER,
+      omitted INTEGER NOT NULL,
+      exit_code INTEGER
+    );
+    CREATE INDEX IF NOT EXISTS runs_created_at_idx ON runs(created_at);
+    CREATE INDEX IF NOT EXISTS runs_filter_kind_idx ON runs(filter_kind);
+  `);
+    return database;
+}
+export function recordRun(statistic, databasePath = defaultStatsPath()) {
+    const database = openDatabase(databasePath);
+    try {
+        database
+            .prepare(`
+        INSERT INTO runs (
+          mode, filter_kind, command_name, raw_bytes, output_bytes,
+          raw_estimated_tokens, output_estimated_tokens, estimated_tokens_saved,
+          reduction_percent, duration_ms, omitted, exit_code
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `)
+            .run(statistic.mode, statistic.filterKind, statistic.commandName, statistic.measurements.rawBytes, statistic.measurements.outputBytes, statistic.measurements.rawEstimatedTokens, statistic.measurements.outputEstimatedTokens, statistic.measurements.estimatedTokensSaved, statistic.measurements.reductionPercent, statistic.durationMs ?? null, statistic.omitted ? 1 : 0, statistic.exitCode ?? null);
+    }
+    finally {
+        database.close();
+    }
+}
+function toStatsRow(row, filterKind = "all") {
+    const raw = Number(row.raw_tokens ?? 0);
+    const output = Number(row.output_tokens ?? 0);
+    return {
+        filterKind,
+        runs: Number(row.runs ?? 0),
+        rawEstimatedTokens: raw,
+        outputEstimatedTokens: output,
+        estimatedTokensSaved: Number(row.tokens_saved ?? 0),
+        reductionPercent: raw === 0 ? 0 : Math.max(0, Math.round((1 - output / raw) * 100)),
+    };
+}
+const AGGREGATE = `
+  COUNT(*) AS runs,
+  COALESCE(SUM(raw_estimated_tokens), 0) AS raw_tokens,
+  COALESCE(SUM(output_estimated_tokens), 0) AS output_tokens,
+  COALESCE(SUM(estimated_tokens_saved), 0) AS tokens_saved
+`;
+export function getStats(databasePath = defaultStatsPath()) {
+    const database = openDatabase(databasePath);
+    try {
+        const total = database
+            .prepare(`SELECT ${AGGREGATE} FROM runs`)
+            .get();
+        const last7Days = database
+            .prepare(`SELECT ${AGGREGATE} FROM runs WHERE created_at >= datetime('now', '-7 days')`)
+            .get();
+        const byFilter = database
+            .prepare(`
+        SELECT filter_kind, ${AGGREGATE}
+        FROM runs
+        GROUP BY filter_kind
+        ORDER BY tokens_saved DESC, filter_kind ASC
+      `)
+            .all();
+        const daily = database
+            .prepare(`
+        SELECT substr(created_at, 1, 10) AS date, ${AGGREGATE}
+        FROM runs
+        WHERE created_at >= datetime('now', '-30 days')
+        GROUP BY substr(created_at, 1, 10)
+        ORDER BY date ASC
+      `)
+            .all();
+        return {
+            databasePath,
+            total: toStatsRow(total),
+            last7Days: toStatsRow(last7Days),
+            byFilter: byFilter.map((row) => toStatsRow(row, row.filter_kind ?? "unknown")),
+            daily: daily.map((row) => ({
+                date: row.date ?? "unknown",
+                runs: Number(row.runs ?? 0),
+                estimatedTokensSaved: Number(row.tokens_saved ?? 0),
+                reductionPercent: toStatsRow(row).reductionPercent,
+            })),
+        };
+    }
+    finally {
+        database.close();
+    }
+}
+function formatInteger(value) {
+    return new Intl.NumberFormat("en-US").format(value);
+}
+function formatRuns(value) {
+    return `${formatInteger(value)} ${value === 1 ? "run" : "runs"}`;
+}
+function formatPercent(value) {
+    return `${value}%`;
+}
+function makeBar(value, maxValue, width = 18) {
+    if (maxValue <= 0 || value <= 0)
+        return "-".repeat(width);
+    const filled = Math.max(1, Math.round((value / maxValue) * width));
+    return `${"#".repeat(Math.min(width, filled))}${"-".repeat(Math.max(0, width - filled))}`;
+}
+export function formatStats(summary) {
+    const allTime = `All time: ${formatRuns(summary.total.runs)} | est. ${formatInteger(summary.total.estimatedTokensSaved)} tokens saved | -${summary.total.reductionPercent}%`;
+    const last7 = `Last 7 days: ${formatRuns(summary.last7Days.runs)} | est. ${formatInteger(summary.last7Days.estimatedTokensSaved)} tokens saved | -${summary.last7Days.reductionPercent}%`;
+    const lines = [
+        "Shrinker Token Savings Dashboard",
+        "================================",
+        "Overview",
+        `  ${allTime}`,
+        `  ${last7}`,
+    ];
+    if (summary.byFilter.length > 0) {
+        lines.push("", "By Filter", "  Filter           Runs        Raw         Output      Saved       Reduce   Share   Savings Bar");
+        lines.push("  ---------------  ----------  ----------  ----------  ----------  -------  ------  ------------------");
+        const maxSaved = Math.max(...summary.byFilter.map((row) => row.estimatedTokensSaved));
+        const totalSaved = summary.total.estimatedTokensSaved;
+        for (const row of summary.byFilter) {
+            const share = totalSaved > 0 ? Math.round((row.estimatedTokensSaved / totalSaved) * 100) : 0;
+            lines.push(`  ${row.filterKind.padEnd(15)}  ${formatRuns(row.runs).padStart(10)}  ${formatInteger(row.rawEstimatedTokens).padStart(10)}  ${formatInteger(row.outputEstimatedTokens).padStart(10)}  ${formatInteger(row.estimatedTokensSaved).padStart(10)}  ${`-${formatPercent(row.reductionPercent)}`.padStart(7)}  ${formatPercent(share).padStart(6)}  ${makeBar(row.estimatedTokensSaved, maxSaved)}`);
+        }
+    }
+    lines.push("", "Storage", `  Database: ${summary.databasePath}`);
+    return lines.join("\n");
+}
+export function formatStatsChart(summary) {
+    const lines = ["Shrinker Token Savings - Last 30 Days", "====================================="];
+    if (summary.daily.length === 0) {
+        lines.push("No recorded runs in the last 30 days.");
+        return lines.join("\n");
+    }
+    const maxSaved = Math.max(...summary.daily.map((row) => row.estimatedTokensSaved));
+    lines.push("Date         Runs   Saved   Reduction  Activity");
+    lines.push("----------  -----  ------  ---------  ------------------------------");
+    for (const row of summary.daily) {
+        const bar = makeBar(row.estimatedTokensSaved, maxSaved, 30);
+        lines.push(`${row.date.padEnd(10)}  ${formatInteger(row.runs).padStart(5)}  ${formatInteger(row.estimatedTokensSaved).padStart(6)}  ${formatPercent(row.reductionPercent).padStart(9)}  ${bar}`);
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=stats-store.js.map

package/integrations/install-shrinker.ps1

@@ -0,0 +1,166 @@
+param(
+    [switch]$SkipNpmInstall,
+    [switch]$SkipBuild,
+    [switch]$SkipLink,
+    [switch]$EnableProfileRouting,
+    [switch]$SkipProfile,
+    [switch]$SkipAgentRules,
+    [switch]$CopilotOnly,
+    [switch]$ClaudeOnly,
+    [string]$ProfilePath = $PROFILE
+)
+
+$ErrorActionPreference = "Stop"
+
+if ($EnableProfileRouting -and $SkipProfile) {
+    throw "Use either -EnableProfileRouting or -SkipProfile, not both."
+}
+if ($CopilotOnly -and $ClaudeOnly) {
+    throw "Use either -CopilotOnly or -ClaudeOnly, not both."
+}
+
+$blockStart = "<!-- shrinker agent rules start -->"
+$blockEnd = "<!-- shrinker agent rules end -->"
+
+function Set-AgentRules {
+    param(
+        [string]$RepoRoot,
+        [string]$Body
+    )
+
+    $targets = @()
+    if (-not $ClaudeOnly) { $targets += (Join-Path $RepoRoot ".copilot-instructions.md") }
+    if (-not $CopilotOnly) { $targets += (Join-Path $RepoRoot "CLAUDE.md") }
+
+    foreach ($target in $targets) {
+        $content = if (Test-Path $target) { Get-Content -Path $target -Raw } else { "" }
+        $newBlock = "$blockStart`n$Body`n$blockEnd"
+        if ($content -and $content.Contains($blockStart) -and $content.Contains($blockEnd)) {
+            $pattern = [regex]::Escape($blockStart) + ".*?" + [regex]::Escape($blockEnd)
+            $content = [regex]::Replace($content, $pattern, $newBlock, [System.Text.RegularExpressions.RegexOptions]::Singleline)
+            Set-Content -Path $target -Value $content
+        } elseif ($content) {
+            Add-Content -Path $target -Value "`n$newBlock`n"
+        } else {
+            Set-Content -Path $target -Value "$newBlock`n"
+        }
+        Write-Host "Installed managed rules in: $target"
+    }
+}
+
+function Test-NodeVersion {
+    $versionText = & node -v 2>$null
+    if (-not $versionText) {
+        throw "Node.js was not found on PATH. Install Node.js 22.13+ first."
+    }
+
+    $match = [regex]::Match($versionText, "^v(\d+)\.(\d+)\.(\d+)$")
+    if (-not $match.Success) {
+        throw "Could not parse Node.js version: $versionText"
+    }
+
+    $major = [int]$match.Groups[1].Value
+    $minor = [int]$match.Groups[2].Value
+    $patch = [int]$match.Groups[3].Value
+
+    if ($major -lt 22 -or ($major -eq 22 -and $minor -lt 13)) {
+        throw "Node.js 22.13+ is required. Found $versionText"
+    }
+
+    return $versionText
+}
+
+function Add-ProfileIntegration {
+    param(
+        [string]$ProfileFile,
+        [string]$IntegrationFile
+    )
+
+    if (-not (Test-Path $ProfileFile)) {
+        New-Item -ItemType File -Path $ProfileFile -Force | Out-Null
+    }
+
+    $startMarker = "# >>> shrinker integration >>>"
+    $endMarker = "# <<< shrinker integration <<<"
+
+    $existing = Get-Content -Path $ProfileFile -Raw -ErrorAction SilentlyContinue
+    if ($existing -and $existing.Contains($startMarker)) {
+        Write-Host "Profile already contains shrinker integration block: $ProfileFile"
+        return
+    }
+
+    $block = @"
+$startMarker
+. "$IntegrationFile"
+$endMarker
+"@
+
+    Add-Content -Path $ProfileFile -Value "`n$block`n"
+    Write-Host "Added shrinker integration block to profile: $ProfileFile"
+}
+
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$templatePath = Join-Path $scriptDir "..\templates\agent-rules.md"
+$repoRoot = Resolve-Path (Join-Path $scriptDir "..")
+$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 -Path $templatePath -Raw
+}
+
+Write-Host "Installing shrinker from: $repoRoot"
+$nodeVersion = Test-NodeVersion
+Write-Host "Detected Node.js: $nodeVersion"
+
+Push-Location $repoRoot
+try {
+    if (-not $SkipNpmInstall) {
+        Write-Host "Running npm install..."
+        & npm install
+        if ($LASTEXITCODE -ne 0) {
+            throw "npm install failed with exit code $LASTEXITCODE"
+        }
+    }
+
+    if (-not $SkipBuild) {
+        Write-Host "Running npm run build..."
+        & npm run build --silent
+        if ($LASTEXITCODE -ne 0) {
+            throw "npm run build failed with exit code $LASTEXITCODE"
+        }
+    }
+
+    if (-not $SkipLink) {
+        Write-Host "Running npm link..."
+        & npm link
+        if ($LASTEXITCODE -ne 0) {
+            throw "npm link failed with exit code $LASTEXITCODE"
+        }
+    }
+}
+finally {
+    Pop-Location
+}
+
+if (-not $SkipProfile) {
+    if ($EnableProfileRouting) {
+        Add-ProfileIntegration -ProfileFile $ProfilePath -IntegrationFile $integrationPath
+        Write-Host "Reload your profile with: . `$PROFILE"
+    }
+    else {
+        Write-Host "Profile routing not enabled (default). Native commands remain unchanged."
+        Write-Host "To enable routing later: pwsh -ExecutionPolicy Bypass -File .\integrations\install-shrinker.ps1 -SkipNpmInstall -SkipBuild -SkipLink -EnableProfileRouting"
+    }
+}
+else {
+    Write-Host "Profile routing skipped via -SkipProfile. Native commands remain unchanged."
+}
+
+if (-not $SkipAgentRules) {
+    Set-AgentRules -RepoRoot (Get-Location).Path -Body $rulesBody
+}
+
+Write-Host "Install complete. Try: shrinker help"

package/integrations/install.ps1

@@ -0,0 +1,46 @@
+param(
+    [string]$PackageName = "shrinker-ai",
+    [string]$Registry = "https://registry.npmjs.org",
+    [string]$Version,
+    [switch]$EnableProfileRouting,
+    [switch]$SkipAgentRules,
+    [switch]$CopilotOnly,
+    [switch]$ClaudeOnly
+)
+
+$ErrorActionPreference = "Stop"
+
+if ($CopilotOnly -and $ClaudeOnly) {
+    throw "Use either -CopilotOnly or -ClaudeOnly, not both."
+}
+
+$packageSpec = if ($Version) { "$PackageName@$Version" } else { $PackageName }
+Write-Host "Installing $packageSpec from $Registry..."
+& npm install --global $packageSpec "--registry=$Registry"
+if ($LASTEXITCODE -ne 0) {
+    throw "npm package installation failed with exit code $LASTEXITCODE"
+}
+
+$globalRoot = (& npm root --global).Trim()
+if (-not $globalRoot) {
+    throw "Could not determine the global npm package directory."
+}
+
+$packageRoot = Join-Path $globalRoot ($PackageName -replace '/', '\')
+$localInstaller = Join-Path $packageRoot "integrations\install-shrinker.ps1"
+if (-not (Test-Path $localInstaller)) {
+    throw "Installed package integration not found: $localInstaller"
+}
+
+$localArgs = @("-ExecutionPolicy", "Bypass", "-File", $localInstaller, "-SkipNpmInstall", "-SkipBuild", "-SkipLink")
+if ($EnableProfileRouting) { $localArgs += "-EnableProfileRouting" }
+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 "Package installation complete. Try: shrinker help"