@snevins/repo-mapper 1.4.4 → 1.5.0

package/README.md

@@ -95,9 +95,17 @@ src/pagerank.ts:
 
 ## Caching
 
-Cache is stored in `.repomap.cache.v2/` in the repository root. Files are re-parsed only when modified (mtime-based invalidation).
+Cache is stored in a global directory to avoid polluting your repository:
 
-Clear cache with: `rm -rf .repomap.cache.v2`
+| Platform | Location |
+|----------|----------|
+| Linux | `~/.cache/repo-mapper/` (or `$XDG_CACHE_HOME/repo-mapper/`) |
+| macOS | `~/Library/Caches/repo-mapper/` |
+| Windows | `%LOCALAPPDATA%\repo-mapper\Cache\` |
+
+Each project gets a unique subdirectory based on its path. Files are re-parsed only when modified (mtime-based invalidation).
+
+Clear cache with: `rm -rf ~/.cache/repo-mapper` (Linux) or equivalent for your platform
 
 ## How It Works
 

package/dist/cache.d.ts

@@ -1,8 +1,29 @@
 import type { Cache, Tag } from "./types.js";
+/**
+ * Get the global cache directory following platform conventions.
+ * - Linux: $XDG_CACHE_HOME/repo-mapper or ~/.cache/repo-mapper
+ * - macOS: ~/Library/Caches/repo-mapper
+ * - Windows: %LOCALAPPDATA%/repo-mapper/Cache
+ */
+export declare function getGlobalCacheDir(): string;
+/**
+ * Get a unique project identifier from the root directory path.
+ * Uses first 16 chars of SHA-256 hash to create a unique but short identifier.
+ */
+export declare function getProjectId(rootDir: string): string;
+/**
+ * Get the cache directory for a specific project.
+ */
+export declare function getProjectCacheDir(rootDir: string): string;
 /**
  * Get the shard key (first 2 hex chars of SHA-256 hash).
  */
 export declare function getShardKey(absPath: string): string;
+/**
+ * @deprecated Use getProjectCacheDir() for new code.
+ * This is kept for migration purposes.
+ */
+export declare function getLegacyCacheDir(rootDir: string): string;
 /**
  * Load cache from disk. Returns empty cache if missing, invalid, or refresh=true.
  */

package/dist/cache.js

@@ -1,9 +1,50 @@
 import { readFile, writeFile, mkdir, rename, readdir } from "node:fs/promises";
 import { join } from "node:path";
+import { homedir, platform } from "node:os";
 import { createHash } from "node:crypto";
 const CACHE_VERSION = 2;
-const CACHE_DIR_NAME = `.repomap.cache.v${String(CACHE_VERSION)}`;
 const TAGS_DIR_NAME = "tags";
+/**
+ * Get the global cache directory following platform conventions.
+ * - Linux: $XDG_CACHE_HOME/repo-mapper or ~/.cache/repo-mapper
+ * - macOS: ~/Library/Caches/repo-mapper
+ * - Windows: %LOCALAPPDATA%/repo-mapper/Cache
+ */
+export function getGlobalCacheDir() {
+    const plat = platform();
+    if (plat === "darwin") {
+        return join(homedir(), "Library", "Caches", "repo-mapper");
+    }
+    if (plat === "win32") {
+        const localAppData = process.env.LOCALAPPDATA;
+        if (localAppData) {
+            return join(localAppData, "repo-mapper", "Cache");
+        }
+        return join(homedir(), "AppData", "Local", "repo-mapper", "Cache");
+    }
+    // Linux and other Unix-like systems: follow XDG spec
+    const xdgCache = process.env.XDG_CACHE_HOME;
+    if (xdgCache) {
+        return join(xdgCache, "repo-mapper");
+    }
+    return join(homedir(), ".cache", "repo-mapper");
+}
+/**
+ * Get a unique project identifier from the root directory path.
+ * Uses first 16 chars of SHA-256 hash to create a unique but short identifier.
+ */
+export function getProjectId(rootDir) {
+    const hash = createHash("sha256").update(rootDir).digest("hex");
+    return hash.slice(0, 16);
+}
+/**
+ * Get the cache directory for a specific project.
+ */
+export function getProjectCacheDir(rootDir) {
+    const globalDir = getGlobalCacheDir();
+    const projectId = getProjectId(rootDir);
+    return join(globalDir, `v${String(CACHE_VERSION)}`, projectId);
+}
 /**
  * Get the shard key (first 2 hex chars of SHA-256 hash).
  */
@@ -12,11 +53,18 @@ export function getShardKey(absPath) {
     return hash.slice(0, 2);
 }
 function getTagsDir(rootDir) {
-    return join(rootDir, CACHE_DIR_NAME, TAGS_DIR_NAME);
+    return join(getProjectCacheDir(rootDir), TAGS_DIR_NAME);
 }
 function getShardPath(rootDir, shardKey) {
     return join(getTagsDir(rootDir), `${shardKey}.json`);
 }
+/**
+ * @deprecated Use getProjectCacheDir() for new code.
+ * This is kept for migration purposes.
+ */
+export function getLegacyCacheDir(rootDir) {
+    return join(rootDir, `.repomap.cache.v${String(CACHE_VERSION)}`);
+}
 /**
  * Load a single shard file.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snevins/repo-mapper",
-  "version": "1.4.4",
+  "version": "1.5.0",
   "description": "Generate token-budgeted repo maps for LLM context using tree-sitter and PageRank",
   "type": "module",
   "main": "dist/index.js",