@ajdev0/token-shrink 2.0.2 → 2.0.3

package/dist/mcp.d.ts

@@ -8,6 +8,11 @@ import { Matcher } from 'chokidar';
  *
  * It maintains its own graph cache by watching the repository root derived
  * from the active file, so Cursor/Claude/Cline agents can request pruned context.
+ *
+ * Root resolution: `--root` (or `ROOT`) pins the project; without one the
+ * server auto-detects it from project markers (`.git`, manifests) — first
+ * around the process cwd, and lazily from `activeFilePath` once a tool call
+ * arrives.
  */
 
 /** Supported auto-rule integration targets. */
@@ -17,6 +22,10 @@ declare const RULE_TARGET_PATH: {
     readonly claude: ".claude/rules/token-shrink.md";
     readonly cline: ".clinerules/token-shrink.md";
 };
+/** Bump when the generated rule bodies gain new tool guidance. */
+declare const RULE_VERSION = 3;
+/** Marker line inside generated rules; its presence means "current version". */
+declare const RULE_VERSION_MARKER = "# token-shrink rule v3";
 declare const AUTO_RULE_SENTINEL = "# auto-generated by token-shrink";
 declare const CURSOR_RULE_PATH: ".cursor/rules/token-shrink.mdc";
 /** Back-compat alias for the previous single-target constant. */
@@ -26,7 +35,12 @@ declare const CLAUDE_RULE_SENTINEL = "# auto-generated by token-shrink (claude)"
 declare const CLINE_RULE_PATH: ".clinerules/token-shrink.md";
 declare const CLINE_RULE_SENTINEL = "# auto-generated by token-shrink (cline)";
 interface McpServerOptions {
-    /** Project root. Defaults to cwd. */
+    /**
+     * Project root to watch. When omitted (and the `ROOT` env var is unset) the
+     * server runs in auto-detect mode: it locates the project from markers
+     * around the process cwd if possible, otherwise lazily from the first tool
+     * call's `activeFilePath`.
+     */
     root?: string;
     /** Extra ignore globs for the watcher. */
     ignored?: Matcher[];
@@ -44,10 +58,11 @@ interface RuleWriteResult {
     filePath: string;
 }
 /**
- * Write a rules file for a given agent target. Idempotent:
- *   - absent  -> create it (tagged with our sentinel);
- *   - has our sentinel -> skip (already ours);
- *   - present without sentinel -> leave the user's file untouched.
+ * Write a rules file for a given agent target. Idempotent and version-aware:
+ *   - absent -> create it (tagged with our sentinel + version marker);
+ *   - has our sentinel AND current version marker -> skip (already ours);
+ *   - has our sentinel but predates the version marker -> rewrite (upgrade);
+ *   - present without our sentinel -> leave the user's file untouched.
  */
 declare function createAutoRule(root: string, target: RuleTarget): RuleWriteResult;
 /** Back-compat alias for code that imported the old Cursor-only helper. */
@@ -58,4 +73,4 @@ declare function createCursorRule(root: string): RuleWriteResult;
  */
 declare function startMcpServer(opts?: McpServerOptions): Promise<McpServer>;
 
-export { AUTO_RULE_PATH, AUTO_RULE_SENTINEL, CLAUDE_RULE_PATH, CLAUDE_RULE_SENTINEL, CLINE_RULE_PATH, CLINE_RULE_SENTINEL, CURSOR_RULE_PATH, type McpServerOptions, RULE_TARGET_PATH, type RuleTarget, type RuleWriteResult, createAutoRule, createCursorRule, startMcpServer };
+export { AUTO_RULE_PATH, AUTO_RULE_SENTINEL, CLAUDE_RULE_PATH, CLAUDE_RULE_SENTINEL, CLINE_RULE_PATH, CLINE_RULE_SENTINEL, CURSOR_RULE_PATH, type McpServerOptions, RULE_TARGET_PATH, RULE_VERSION, RULE_VERSION_MARKER, type RuleTarget, type RuleWriteResult, createAutoRule, createCursorRule, startMcpServer };

package/dist/mcp.js

@@ -8,11 +8,13 @@ import {
   CLINE_RULE_SENTINEL,
   CURSOR_RULE_PATH,
   RULE_TARGET_PATH,
+  RULE_VERSION,
+  RULE_VERSION_MARKER,
   createAutoRule,
   createCursorRule,
   startMcpServer
-} from "./chunk-HBYIAFR4.js";
-import "./chunk-HRF3BIOV.js";
+} from "./chunk-RLHEIKPR.js";
+import "./chunk-FYCLLG7F.js";
 import "./chunk-7SQ6HMWM.js";
 export {
   AUTO_RULE_PATH,
@@ -23,6 +25,8 @@ export {
   CLINE_RULE_SENTINEL,
   CURSOR_RULE_PATH,
   RULE_TARGET_PATH,
+  RULE_VERSION,
+  RULE_VERSION_MARKER,
   createAutoRule,
   createCursorRule,
   startMcpServer

package/hooks/claude/README.md

@@ -0,0 +1,29 @@
+# Claude Code hooks (optional auto-context)
+
+Copy these into your project and merge `settings.example.json` into
+`.claude/settings.json`:
+
+```bash
+mkdir -p .claude/hooks
+cp hooks/claude/git-impact.mjs .claude/hooks/
+cp hooks/claude/settings.example.json .claude/settings.example.json
+# then merge the "hooks" block from settings.example.json into your
+# .claude/settings.json (project- or user-level)
+```
+
+What it does:
+
+- `SessionStart` + `Stop` hooks run `git-impact.mjs`, which prints a compact
+  **git-impact summary** (changed files, unstaged/staged diff stat) whenever the
+  working tree is dirty.
+- Claude Code surfaces hook stdout in the session, so diff context is injected
+  automatically — no prompt engineering required.
+
+Notes & limits:
+
+- This is the lightweight, always-on complement to the heavier
+  `git_diff_context` MCP tool (full changed-file code + pruned caller skeletons),
+  which the auto-workflow rule triggers for multi-file/review work.
+- Hook stdout is cheap: one or two `git` calls per event.
+- If your tree is clean the hook prints nothing useful and exits quietly.
+- The hook runs `git` in `CLAUDE_PROJECT_DIR` (or `$1` when invoked manually).

package/hooks/claude/git-impact.mjs

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+/**
+ * Compact git-impact summary for Claude Code hooks.
+ *
+ * Prints changed files + diff stat when the working tree is dirty; prints
+ * nothing useful (and exits 0) when clean. Intended to be cheap: two git
+ * calls. Pair with the `git_diff_context` MCP tool for the heavy payload.
+ */
+import { execFileSync } from 'node:child_process';
+import path from 'node:path';
+import fs from 'node:fs';
+
+const root = path.resolve(process.argv[2] || process.env.CLAUDE_PROJECT_DIR || process.cwd());
+
+function run(args) {
+  try {
+    return execFileSync('git', ['--no-pager', ...args], {
+      cwd: root,
+      encoding: 'utf8',
+      env: { ...process.env, LC_ALL: 'C' },
+    });
+  } catch {
+    return '';
+  }
+}
+
+// Not a repo (or git missing) -> stay quiet so hooks never error.
+if (!fs.existsSync(path.join(root, '.git')) && !run(['rev-parse', '--is-inside-work-tree']).trim()) {
+  process.exit(0);
+}
+
+const status = run(['status', '--porcelain']).split('\n').filter(Boolean).slice(0, 40);
+if (status.length === 0) {
+  process.exit(0);
+}
+
+const unstaged = run(['diff', '--stat']).trim();
+const staged = run(['diff', '--cached', '--stat']).trim();
+
+const lines = [
+  `[token-shrink] git impact — ${status.length} changed file${status.length === 1 ? '' : 's'}:`,
+  '',
+  ...status.map((s) => `  ${s}`),
+];
+if (unstaged) lines.push('', 'Unstaged changes:', unstaged);
+if (staged) lines.push('', 'Staged changes:', staged);
+console.log(lines.join('\n'));

package/hooks/claude/settings.example.json

@@ -0,0 +1,24 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/git-impact.mjs\""
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"$CLAUDE_PROJECT_DIR/.claude/hooks/git-impact.mjs\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ajdev0/token-shrink",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "description": "Polyglot AST Semantic Proxy & MCP Server — local-first, framework-aware token reduction engine",
   "type": "module",
   "license": "MIT",
@@ -29,6 +29,7 @@
   "files": [
     "dist",
     "wasm",
+    "hooks",
     "README.md"
   ],
   "engines": {

package/dist/chunk-HBYIAFR4.js

@@ -1,204 +0,0 @@
-#!/usr/bin/env node
-import {
-  assemble,
-  createWatcher
-} from "./chunk-HRF3BIOV.js";
-
-// src/mcp.ts
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
-import fs from "fs";
-import path from "path";
-var RULE_TARGET_PATH = {
-  cursor: ".cursor/rules/token-shrink.mdc",
-  claude: ".claude/rules/token-shrink.md",
-  cline: ".clinerules/token-shrink.md"
-};
-var AUTO_RULE_SENTINEL = "# auto-generated by token-shrink";
-var CURSOR_RULE_PATH = RULE_TARGET_PATH.cursor;
-var AUTO_RULE_PATH = CURSOR_RULE_PATH;
-var CLAUDE_RULE_PATH = RULE_TARGET_PATH.claude;
-var CLAUDE_RULE_SENTINEL = "# auto-generated by token-shrink (claude)";
-var CLINE_RULE_PATH = RULE_TARGET_PATH.cline;
-var CLINE_RULE_SENTINEL = "# auto-generated by token-shrink (cline)";
-var ruleTargets = {
-  cursor: {
-    relPath: CURSOR_RULE_PATH,
-    sentinel: AUTO_RULE_SENTINEL,
-    body: `---
-description: Compress dependency context with token-shrink on every task
-globs: **/*.{ts,tsx,js,jsx,py,go,rs,dart,swift,java,kt,c,cpp,h,hpp,php}
-alwaysApply: true
----
-Before working on a file in this repo, call the \`get_compressed_code_context\` MCP tool with
-that file's path, and use the returned Ring 0 + Ring 1 payload as the context for that file
-and its direct imports.
-
-${AUTO_RULE_SENTINEL}
-`
-  },
-  claude: {
-    relPath: CLAUDE_RULE_PATH,
-    sentinel: CLAUDE_RULE_SENTINEL,
-    body: `---
-description: Compress dependency context with token-shrink on every task
-paths: ["**/*.{ts,tsx,js,jsx,py,go,rs,dart,swift,java,kt,c,cpp,h,hpp,php}"]
----
-Before working on a file in this repo, call the \`get_compressed_code_context\` MCP tool with
-that file's path, and use the returned Ring 0 + Ring 1 payload as the context for that file
-and its direct imports.
-
-${CLAUDE_RULE_SENTINEL}
-`
-  },
-  cline: {
-    relPath: CLINE_RULE_PATH,
-    sentinel: CLINE_RULE_SENTINEL,
-    // No frontmatter -> always-on rule (Cline treats unconditional .clinerules/*.md
-    // files as universal rules, applied to every task regardless of active file).
-    body: `# token-shrink
-
-Before working on a file in this repo, call the \`get_compressed_code_context\` MCP tool with
-that file's path, and use the returned Ring 0 + Ring 1 payload as the context for that file
-and its direct imports.
-
-${CLINE_RULE_SENTINEL}
-`
-  }
-};
-function createAutoRule(root, target) {
-  const spec = ruleTargets[target];
-  const rulePath = path.join(root, spec.relPath);
-  try {
-    if (fs.existsSync(rulePath)) {
-      const existing = fs.readFileSync(rulePath, "utf8");
-      if (existing.includes(spec.sentinel)) {
-        return { created: false, skipped: "exists", filePath: rulePath };
-      }
-      return { created: false, skipped: "user", filePath: rulePath };
-    }
-    fs.mkdirSync(path.dirname(rulePath), { recursive: true });
-    fs.writeFileSync(rulePath, spec.body, "utf8");
-    return { created: true, skipped: "none", filePath: rulePath };
-  } catch (err) {
-    process.stderr.write(
-      `[token-shrink] Failed to write rule for "${target}": ${err.message}
-`
-    );
-    return { created: false, skipped: "none", filePath: rulePath };
-  }
-}
-function createCursorRule(root) {
-  return createAutoRule(root, "cursor");
-}
-function resolveTargets(ruleTarget) {
-  if (!ruleTarget) return ["cursor", "claude", "cline"];
-  const list = Array.isArray(ruleTarget) ? ruleTarget : [ruleTarget];
-  if (list.includes("all")) return ["cursor", "claude", "cline"];
-  return list;
-}
-async function startMcpServer(opts = {}) {
-  const root = path.resolve(opts.root ?? process.env.ROOT ?? process.cwd());
-  const log = (msg) => {
-    if (!opts.silent) process.stderr.write(`[token-shrink] ${msg}
-`);
-  };
-  const watcher = createWatcher({ root, ignored: opts.ignored });
-  if (!opts.silent) {
-    log(`Indexing ${root} in the background\u2026`);
-  }
-  if (opts.createRule !== false) {
-    for (const target of resolveTargets(opts.ruleTarget)) {
-      const res = createAutoRule(root, target);
-      if (res.created) {
-        log(`Wrote ${target} rule to ${res.filePath}`);
-      } else if (res.skipped === "user") {
-        log(`${target} rule exists (user-authored); leaving it untouched.`);
-      }
-    }
-  }
-  void watcher.indexAll().then((n) => log(`Indexed ${n} files.`));
-  const server = new McpServer(
-    { name: "token-shrink", version: "2.0.0" },
-    { capabilities: { tools: {} } }
-  );
-  server.registerTool(
-    "get_compressed_code_context",
-    {
-      title: "Get Compressed Code Context",
-      description: "Returns a compressed, framework-aware AST context payload for a file: the active file\u2019s full source (Ring 0) plus pruned skeletons of its direct imports (Ring 1). Implementation bodies are removed but type signatures, interfaces, and module exports are preserved for ~80-90% token reduction.",
-      inputSchema: {
-        activeFilePath: z.string().describe("Path to the file the agent is working on"),
-        maxSkeletons: z.number().int().min(1).max(200).optional().describe("Cap on number of dependency skeletons to include"),
-        includeStats: z.boolean().optional().describe("Append approximate token-count stats")
-      }
-    },
-    async ({ activeFilePath, maxSkeletons, includeStats }) => {
-      const result = assemble(activeFilePath, watcher.cache.entries, {
-        maxSkeletons,
-        includeStats
-      });
-      return {
-        content: [
-          {
-            type: "text",
-            text: result.markdown
-          },
-          {
-            type: "text",
-            text: `[stats] active=${result.activeFilePath} dependencies=${result.included.length} unresolved=${result.unresolved.length}`
-          }
-        ]
-      };
-    }
-  );
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-  log("MCP server connected.");
-  return server;
-}
-var argv1 = process.argv[1] ? path.basename(process.argv[1]) : "";
-var argv1Real = "";
-try {
-  argv1Real = process.argv[1] ? path.basename(fs.realpathSync(process.argv[1])) : "";
-} catch {
-}
-var invokedAsMcp = argv1 === "mcp.js" || argv1 === "mcp.mjs" || argv1 === "mcp.cjs" || argv1 === "mcp.ts" || argv1Real === "mcp.js" || argv1Real === "mcp.mjs" || argv1Real === "mcp.cjs" || argv1Real === "mcp.ts";
-if (invokedAsMcp) {
-  const rootArg = (() => {
-    const i = process.argv.indexOf("--root");
-    if (i !== -1 && process.argv[i + 1]) return process.argv[i + 1];
-    const eq = process.argv.find((a) => a.startsWith("--root="));
-    if (eq) return eq.slice("--root=".length);
-    return void 0;
-  })();
-  const createRule = !(process.env.TOKEN_SHRINK_CREATE_RULE === "0" || process.env.TOKEN_SHRINK_CREATE_RULE === "false" || process.env.CONTEXT_SHRINK_CREATE_RULE === "0" || process.env.CONTEXT_SHRINK_CREATE_RULE === "false" || process.argv.includes("--no-create-rule") || (() => {
-    const f = process.argv.find((a) => a.startsWith("--create-rule="));
-    return f ? f.slice("--create-rule=".length) === "false" : false;
-  })());
-  const rawTargets = process.argv.filter((a) => a.startsWith("--rule-target=")).flatMap((a) => a.slice("--rule-target=".length).split(","));
-  const ruleTarget = rawTargets.length > 0 && !rawTargets.includes("all") ? [...new Set(rawTargets)].filter(
-    (v) => v === "cursor" || v === "claude" || v === "cline"
-  ) : void 0;
-  void startMcpServer({ root: rootArg, createRule, ruleTarget }).catch((err) => {
-    process.stderr.write(`[token-shrink] MCP server error: ${err.message}
-`);
-    process.exitCode = 1;
-  });
-}
-
-export {
-  RULE_TARGET_PATH,
-  AUTO_RULE_SENTINEL,
-  CURSOR_RULE_PATH,
-  AUTO_RULE_PATH,
-  CLAUDE_RULE_PATH,
-  CLAUDE_RULE_SENTINEL,
-  CLINE_RULE_PATH,
-  CLINE_RULE_SENTINEL,
-  createAutoRule,
-  createCursorRule,
-  startMcpServer
-};
-//# sourceMappingURL=chunk-HBYIAFR4.js.map

package/dist/chunk-HBYIAFR4.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/mcp.ts"],"sourcesContent":["/**\n * MCP stdio server. Exposes a single tool:\n *\n *   get_compressed_code_context({ activeFilePath, maxSkeletons?, includeStats? })\n *\n * It maintains its own graph cache by watching the repository root derived\n * from the active file, so Cursor/Claude/Cline agents can request pruned context.\n */\n\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { z } from 'zod';\nimport fs from 'node:fs';\nimport path from 'node:path';\n\nimport { assemble } from './server/assembler.js';\nimport { createWatcher, type Matcher } from './watcher/sync.js';\n\n/** Supported auto-rule integration targets. */\nexport type RuleTarget = 'cursor' | 'claude' | 'cline';\n\n/** Agent integration file descriptors written when the auto-rule is on. */\ninterface RuleTargetSpec {\n  relPath: string;\n  sentinel: string;\n  body: string;\n}\n\nexport const RULE_TARGET_PATH = {\n  cursor: '.cursor/rules/token-shrink.mdc',\n  claude: '.claude/rules/token-shrink.md',\n  cline: '.clinerules/token-shrink.md',\n} as const;\n\nexport const AUTO_RULE_SENTINEL = '# auto-generated by token-shrink';\nexport const CURSOR_RULE_PATH = RULE_TARGET_PATH.cursor;\n/** Back-compat alias for the previous single-target constant. */\nexport const AUTO_RULE_PATH = CURSOR_RULE_PATH;\nexport const CLAUDE_RULE_PATH = RULE_TARGET_PATH.claude;\nexport const CLAUDE_RULE_SENTINEL = '# auto-generated by token-shrink (claude)';\nexport const CLINE_RULE_PATH = RULE_TARGET_PATH.cline;\nexport const CLINE_RULE_SENTINEL = '# auto-generated by token-shrink (cline)';\n\nconst ruleTargets: Record<RuleTarget, RuleTargetSpec> = {\n  cursor: {\n    relPath: CURSOR_RULE_PATH,\n    sentinel: AUTO_RULE_SENTINEL,\n    body: `---\ndescription: Compress dependency context with token-shrink on every task\nglobs: **/*.{ts,tsx,js,jsx,py,go,rs,dart,swift,java,kt,c,cpp,h,hpp,php}\nalwaysApply: true\n---\nBefore working on a file in this repo, call the \\`get_compressed_code_context\\` MCP tool with\nthat file's path, and use the returned Ring 0 + Ring 1 payload as the context for that file\nand its direct imports.\n\n${AUTO_RULE_SENTINEL}\n`,\n  },\n  claude: {\n    relPath: CLAUDE_RULE_PATH,\n    sentinel: CLAUDE_RULE_SENTINEL,\n    body: `---\ndescription: Compress dependency context with token-shrink on every task\npaths: [\"**/*.{ts,tsx,js,jsx,py,go,rs,dart,swift,java,kt,c,cpp,h,hpp,php}\"]\n---\nBefore working on a file in this repo, call the \\`get_compressed_code_context\\` MCP tool with\nthat file's path, and use the returned Ring 0 + Ring 1 payload as the context for that file\nand its direct imports.\n\n${CLAUDE_RULE_SENTINEL}\n`,\n  },\n  cline: {\n    relPath: CLINE_RULE_PATH,\n    sentinel: CLINE_RULE_SENTINEL,\n    // No frontmatter -> always-on rule (Cline treats unconditional .clinerules/*.md\n    // files as universal rules, applied to every task regardless of active file).\n    body: `# token-shrink\n\nBefore working on a file in this repo, call the \\`get_compressed_code_context\\` MCP tool with\nthat file's path, and use the returned Ring 0 + Ring 1 payload as the context for that file\nand its direct imports.\n\n${CLINE_RULE_SENTINEL}\n`,\n  },\n};\n\nexport interface McpServerOptions {\n  /** Project root. Defaults to cwd. */\n  root?: string;\n  /** Extra ignore globs for the watcher. */\n  ignored?: Matcher[];\n  /** Silence log output (stdio must stay clean for the MCP protocol). */\n  silent?: boolean;\n  /** Whether to auto-write agent integration rules at all. Default true. */\n  createRule?: boolean;\n  /** Which agent rule target(s) to write. Default all. */\n  ruleTarget?: RuleTarget | RuleTarget[];\n}\n\nexport interface RuleWriteResult {\n  created: boolean;\n  skipped: 'none' | 'exists' | 'user';\n  /** Path of the rule file that was considered. */\n  filePath: string;\n}\n\n/**\n * Write a rules file for a given agent target. Idempotent:\n *   - absent  -> create it (tagged with our sentinel);\n *   - has our sentinel -> skip (already ours);\n *   - present without sentinel -> leave the user's file untouched.\n */\nexport function createAutoRule(root: string, target: RuleTarget): RuleWriteResult {\n  const spec = ruleTargets[target];\n  const rulePath = path.join(root, spec.relPath);\n  try {\n    if (fs.existsSync(rulePath)) {\n      const existing = fs.readFileSync(rulePath, 'utf8');\n      if (existing.includes(spec.sentinel)) {\n        return { created: false, skipped: 'exists', filePath: rulePath };\n      }\n      return { created: false, skipped: 'user', filePath: rulePath };\n    }\n    fs.mkdirSync(path.dirname(rulePath), { recursive: true });\n    fs.writeFileSync(rulePath, spec.body, 'utf8');\n    return { created: true, skipped: 'none', filePath: rulePath };\n  } catch (err) {\n    // Never let a rule-write failure take down the MCP server; surface via result.\n    process.stderr.write(\n      `[token-shrink] Failed to write rule for \"${target}\": ${(err as Error).message}\\n`,\n    );\n    return { created: false, skipped: 'none', filePath: rulePath };\n  }\n}\n\n/** Back-compat alias for code that imported the old Cursor-only helper. */\nexport function createCursorRule(root: string): RuleWriteResult {\n  return createAutoRule(root, 'cursor');\n}\n\n/** Expand `ruleTarget` (single / array / all) into the ordered list to write. */\nfunction resolveTargets(ruleTarget: McpServerOptions['ruleTarget']): RuleTarget[] {\n  if (!ruleTarget) return ['cursor', 'claude', 'cline'];\n  const list = Array.isArray(ruleTarget) ? ruleTarget : [ruleTarget];\n  if (list.includes('all' as unknown as RuleTarget)) return ['cursor', 'claude', 'cline'];\n  return list;\n}\n\n/**\n * Start the MCP server. Because the MCP protocol runs over stdio, all human\n * logging should go to stderr; stdout is reserved for JSON-RPC.\n */\nexport async function startMcpServer(opts: McpServerOptions = {}): Promise<McpServer> {\n  const root = path.resolve(opts.root ?? process.env.ROOT ?? process.cwd());\n  const log = (msg: string) => {\n    if (!opts.silent) process.stderr.write(`[token-shrink] ${msg}\\n`);\n  };\n\n  const watcher = createWatcher({ root, ignored: opts.ignored });\n  if (!opts.silent) {\n    log(`Indexing ${root} in the background…`);\n  }\n\n  // Auto-create agent integration rules so the tool is used by default.\n  if (opts.createRule !== false) {\n    for (const target of resolveTargets(opts.ruleTarget)) {\n      const res = createAutoRule(root, target);\n      if (res.created) {\n        log(`Wrote ${target} rule to ${res.filePath}`);\n      } else if (res.skipped === 'user') {\n        log(`${target} rule exists (user-authored); leaving it untouched.`);\n      }\n    }\n  }\n  // Fire-and-forget cold start; zero CPU afterward thanks to the watcher.\n  void watcher.indexAll().then((n) => log(`Indexed ${n} files.`));\n\n  const server = new McpServer(\n    { name: 'token-shrink', version: '2.0.0' },\n    { capabilities: { tools: {} } },\n  );\n\n  server.registerTool(\n    'get_compressed_code_context',\n    {\n      title: 'Get Compressed Code Context',\n      description:\n        'Returns a compressed, framework-aware AST context payload for a file: ' +\n        'the active file’s full source (Ring 0) plus pruned skeletons of its direct ' +\n        'imports (Ring 1). Implementation bodies are removed but type signatures, ' +\n        'interfaces, and module exports are preserved for ~80-90% token reduction.',\n      inputSchema: {\n        activeFilePath: z.string().describe('Path to the file the agent is working on'),\n        maxSkeletons: z\n          .number()\n          .int()\n          .min(1)\n          .max(200)\n          .optional()\n          .describe('Cap on number of dependency skeletons to include'),\n        includeStats: z\n          .boolean()\n          .optional()\n          .describe('Append approximate token-count stats'),\n      },\n    },\n    async ({ activeFilePath, maxSkeletons, includeStats }) => {\n      const result = assemble(activeFilePath, watcher.cache.entries, {\n        maxSkeletons,\n        includeStats,\n      });\n      return {\n        content: [\n          {\n            type: 'text' as const,\n            text: result.markdown,\n          },\n          {\n            type: 'text' as const,\n            text: `[stats] active=${result.activeFilePath} dependencies=${result.included.length} unresolved=${result.unresolved.length}`,\n          },\n        ],\n      };\n    },\n  );\n\n  const transport = new StdioServerTransport();\n  await server.connect(transport);\n  log('MCP server connected.');\n  return server;\n}\n\n// Start the server only when run as the MCP binary, not when imported as a\n// library. Guard against both the source filenames and the tsup bundles:\n// `dist/mcp.cjs` (used by the npm `token-shrink-mcp` bin). `realpathSync`\n// resolves the npm bin symlink, so `token-shrink-mcp` -> `dist/mcp.cjs` is\n// detected as `mcp.cjs`.\nconst argv1 = process.argv[1] ? path.basename(process.argv[1]) : '';\nlet argv1Real = '';\ntry {\n  argv1Real = process.argv[1]\n    ? path.basename(fs.realpathSync(process.argv[1]))\n    : '';\n} catch {\n  /* path may not exist yet (tsx/dev runners) — fall back to argv basename */\n}\nconst invokedAsMcp =\n  argv1 === 'mcp.js' || argv1 === 'mcp.mjs' ||\n  argv1 === 'mcp.cjs' || argv1 === 'mcp.ts' ||\n  argv1Real === 'mcp.js' || argv1Real === 'mcp.mjs' ||\n  argv1Real === 'mcp.cjs' || argv1Real === 'mcp.ts';\nif (invokedAsMcp) {\n  const rootArg = (() => {\n    const i = process.argv.indexOf('--root');\n    if (i !== -1 && process.argv[i + 1]) return process.argv[i + 1];\n    const eq = process.argv.find((a) => a.startsWith('--root='));\n    if (eq) return eq.slice('--root='.length);\n    return undefined;\n  })();\n  const createRule = !(\n    process.env.TOKEN_SHRINK_CREATE_RULE === '0' ||\n    process.env.TOKEN_SHRINK_CREATE_RULE === 'false' ||\n    process.env.CONTEXT_SHRINK_CREATE_RULE === '0' ||\n    process.env.CONTEXT_SHRINK_CREATE_RULE === 'false' ||\n    process.argv.includes('--no-create-rule') ||\n    (() => {\n      const f = process.argv.find((a) => a.startsWith('--create-rule='));\n      return f ? f.slice('--create-rule='.length) === 'false' : false;\n    })()\n  );\n  // --rule-target=cursor|claude|cline|all (repeatable / comma-separated), default all.\n  const rawTargets = process.argv\n    .filter((a) => a.startsWith('--rule-target='))\n    .flatMap((a) => a.slice('--rule-target='.length).split(','));\n  const ruleTarget: RuleTarget | RuleTarget[] | undefined =\n    rawTargets.length > 0 && !rawTargets.includes('all')\n      ? ([...new Set(rawTargets)].filter(\n          (v): v is RuleTarget => v === 'cursor' || v === 'claude' || v === 'cline',\n        ) as RuleTarget[])\n      : undefined;\n  void startMcpServer({ root: rootArg, createRule, ruleTarget }).catch((err) => {\n    process.stderr.write(`[token-shrink] MCP server error: ${err.message}\\n`);\n    process.exitCode = 1;\n  });\n}\n"],"mappings":"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","names":[]}