whale-code 6.5.6 → 6.5.7

package/dist/cli/services/project-index.js

@@ -0,0 +1,286 @@
+/**
+ * Project Index — lightweight file map cached in .whale/index.json.
+ *
+ * On first query: walks the project tree, records metadata per file.
+ * On subsequent sessions: refreshes incrementally via mtime checks.
+ * Used for: "which files handle X?" queries, smarter glob suggestions, context awareness.
+ */
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync, statSync, readdirSync } from "fs";
+import { join, relative, extname } from "path";
+import { homedir } from "os";
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+
+const INDEX_VERSION = 1;
+const INDEX_DIR = join(homedir(), ".whale");
+const INDEX_FILE = "index.json";
+const LANG_MAP = {
+  ".ts": "typescript",
+  ".tsx": "typescript",
+  ".js": "javascript",
+  ".jsx": "javascript",
+  ".mjs": "javascript",
+  ".cjs": "javascript",
+  ".py": "python",
+  ".rb": "ruby",
+  ".go": "go",
+  ".rs": "rust",
+  ".java": "java",
+  ".kt": "kotlin",
+  ".scala": "scala",
+  ".swift": "swift",
+  ".m": "objc",
+  ".mm": "objc",
+  ".c": "c",
+  ".h": "c",
+  ".cpp": "cpp",
+  ".hpp": "cpp",
+  ".cc": "cpp",
+  ".cs": "csharp",
+  ".php": "php",
+  ".lua": "lua",
+  ".r": "r",
+  ".sql": "sql",
+  ".sh": "shell",
+  ".bash": "shell",
+  ".zsh": "shell",
+  ".json": "json",
+  ".yaml": "yaml",
+  ".yml": "yaml",
+  ".toml": "toml",
+  ".xml": "xml",
+  ".html": "html",
+  ".css": "css",
+  ".scss": "scss",
+  ".md": "markdown",
+  ".mdx": "markdown"
+};
+const IGNORE_DIRS = new Set(["node_modules", ".git", ".svn", ".hg", "dist", "build", "out", ".next", ".nuxt", ".cache", ".turbo", ".parcel-cache", "__pycache__", ".pytest_cache", "venv", ".venv", "target", "Pods", "DerivedData", ".build", "coverage", ".nyc_output"]);
+const IGNORE_EXTENSIONS = new Set([".map", ".min.js", ".min.css", ".lock", ".log", ".png", ".jpg", ".jpeg", ".gif", ".ico", ".svg", ".webp", ".woff", ".woff2", ".ttf", ".eot", ".mp3", ".mp4", ".wav", ".avi", ".mov", ".zip", ".tar", ".gz", ".bz2", ".7z", ".exe", ".dll", ".so", ".dylib", ".o", ".a", ".pyc", ".pyo", ".class"]);
+const MAX_FILES = 5000;
+const MAX_FILE_SIZE_FOR_EXPORTS = 500_000; // 500KB
+
+// ============================================================================
+// EXPORT EXTRACTION (lightweight, regex-based)
+// ============================================================================
+
+const EXPORT_PATTERNS = {
+  typescript: [/^export\s+(?:async\s+)?function\s+(\w+)/gm, /^export\s+class\s+(\w+)/gm, /^export\s+(?:const|let|var)\s+(\w+)/gm, /^export\s+type\s+(\w+)/gm, /^export\s+interface\s+(\w+)/gm, /^export\s+enum\s+(\w+)/gm, /^export\s+default\s+(?:function|class)\s+(\w+)/gm],
+  javascript: [/^export\s+(?:async\s+)?function\s+(\w+)/gm, /^export\s+class\s+(\w+)/gm, /^export\s+(?:const|let|var)\s+(\w+)/gm, /^export\s+default\s+(?:function|class)\s+(\w+)/gm, /^module\.exports\s*=\s*\{\s*([^}]+)\}/gm],
+  python: [/^def\s+(\w+)\s*\(/gm, /^class\s+(\w+)/gm, /^(\w+)\s*=\s*/gm],
+  go: [/^func\s+(\w+)/gm, /^type\s+(\w+)\s+(?:struct|interface)/gm],
+  rust: [/^pub\s+(?:async\s+)?fn\s+(\w+)/gm, /^pub\s+struct\s+(\w+)/gm, /^pub\s+enum\s+(\w+)/gm, /^pub\s+trait\s+(\w+)/gm],
+  swift: [/^(?:public\s+|open\s+)?func\s+(\w+)/gm, /^(?:public\s+|open\s+)?class\s+(\w+)/gm, /^(?:public\s+|open\s+)?struct\s+(\w+)/gm, /^(?:public\s+|open\s+)?enum\s+(\w+)/gm, /^(?:public\s+|open\s+)?protocol\s+(\w+)/gm]
+};
+function extractExports(content, language) {
+  const patterns = EXPORT_PATTERNS[language];
+  if (!patterns) return [];
+  const exports = new Set();
+  for (const pattern of patterns) {
+    pattern.lastIndex = 0;
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+      const name = match[1]?.trim();
+      if (name && !name.startsWith("_")) {
+        exports.add(name);
+      }
+    }
+  }
+  return Array.from(exports).sort();
+}
+
+// ============================================================================
+// DIRECTORY WALKER
+// ============================================================================
+
+function walkDirectory(root, maxFiles) {
+  const results = [];
+  function walk(dir, depth) {
+    if (results.length >= maxFiles || depth > 15) return;
+    let entries;
+    try {
+      entries = readdirSync(dir);
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (results.length >= maxFiles) return;
+      if (entry.startsWith(".") && entry !== ".github") continue;
+      const fullPath = join(dir, entry);
+      let stat;
+      try {
+        stat = statSync(fullPath);
+      } catch {
+        continue;
+      }
+      if (stat.isDirectory()) {
+        if (!IGNORE_DIRS.has(entry)) {
+          walk(fullPath, depth + 1);
+        }
+      } else if (stat.isFile()) {
+        const ext = extname(entry).toLowerCase();
+        if (IGNORE_EXTENSIONS.has(ext)) continue;
+        if (stat.size > 10_000_000) continue; // Skip files > 10MB
+
+        results.push({
+          path: relative(root, fullPath),
+          size: stat.size,
+          mtime: stat.mtimeMs
+        });
+      }
+    }
+  }
+  walk(root, 0);
+  return results;
+}
+
+// ============================================================================
+// INDEX BUILD / REFRESH
+// ============================================================================
+
+function getIndexPath(projectRoot) {
+  // Hash the project root to create a unique index file per project
+  let hash = 0;
+  for (let i = 0; i < projectRoot.length; i++) {
+    hash = (hash << 5) - hash + projectRoot.charCodeAt(i) | 0;
+  }
+  return join(INDEX_DIR, `index-${Math.abs(hash).toString(36)}.json`);
+}
+function buildFileEntry(root, fileMeta) {
+  const ext = extname(fileMeta.path).toLowerCase();
+  const language = LANG_MAP[ext] || ext.slice(1) || "unknown";
+  let exports = [];
+  if (fileMeta.size <= MAX_FILE_SIZE_FOR_EXPORTS && EXPORT_PATTERNS[language]) {
+    try {
+      const content = readFileSync(join(root, fileMeta.path), "utf-8");
+      exports = extractExports(content, language);
+    } catch {
+      // File unreadable — skip exports
+    }
+  }
+  return {
+    path: fileMeta.path,
+    size: fileMeta.size,
+    mtime: fileMeta.mtime,
+    language,
+    exports
+  };
+}
+export function buildIndex(projectRoot) {
+  const fileMetas = walkDirectory(projectRoot, MAX_FILES);
+  const files = fileMetas.map(fm => buildFileEntry(projectRoot, fm));
+  return {
+    root: projectRoot,
+    version: INDEX_VERSION,
+    updatedAt: new Date().toISOString(),
+    files
+  };
+}
+export function refreshIndex(existing, projectRoot) {
+  const fileMetas = walkDirectory(projectRoot, MAX_FILES);
+  const existingMap = new Map(existing.files.map(f => [f.path, f]));
+  const files = [];
+  for (const fm of fileMetas) {
+    const prev = existingMap.get(fm.path);
+    if (prev && Math.abs(prev.mtime - fm.mtime) < 1) {
+      // Unchanged — reuse existing entry
+      files.push(prev);
+    } else {
+      // New or modified — rebuild
+      files.push(buildFileEntry(projectRoot, fm));
+    }
+  }
+  return {
+    root: projectRoot,
+    version: INDEX_VERSION,
+    updatedAt: new Date().toISOString(),
+    files
+  };
+}
+
+// ============================================================================
+// LOAD / SAVE
+// ============================================================================
+
+export function loadIndex(projectRoot) {
+  const indexPath = getIndexPath(projectRoot);
+  if (!existsSync(indexPath)) return null;
+  try {
+    const raw = JSON.parse(readFileSync(indexPath, "utf-8"));
+    if (raw.version !== INDEX_VERSION || raw.root !== projectRoot) return null;
+    return raw;
+  } catch {
+    return null;
+  }
+}
+export function saveIndex(index) {
+  const indexPath = getIndexPath(index.root);
+  try {
+    if (!existsSync(INDEX_DIR)) mkdirSync(INDEX_DIR, {
+      recursive: true
+    });
+    writeFileSync(indexPath, JSON.stringify(index), "utf-8");
+  } catch {
+    // Non-critical — index is a cache
+  }
+}
+
+// ============================================================================
+// QUERY HELPERS
+// ============================================================================
+
+export function getOrRefreshIndex(projectRoot) {
+  const existing = loadIndex(projectRoot);
+  let index;
+  if (existing) {
+    index = refreshIndex(existing, projectRoot);
+  } else {
+    index = buildIndex(projectRoot);
+  }
+  saveIndex(index);
+  return index;
+}
+
+/** Find files that export a given symbol name. */
+export function findExportingFiles(index, symbolName) {
+  return index.files.filter(f => f.exports.includes(symbolName));
+}
+
+/** Find files by language. */
+export function findByLanguage(index, language) {
+  return index.files.filter(f => f.language === language);
+}
+
+/** Find files matching a path pattern (simple substring match). */
+export function findByPath(index, pattern) {
+  const lower = pattern.toLowerCase();
+  return index.files.filter(f => f.path.toLowerCase().includes(lower));
+}
+
+/** Get summary stats for the project. */
+export function getProjectStats(index) {
+  const byLanguage = {};
+  let totalSize = 0;
+  for (const f of index.files) {
+    byLanguage[f.language] = (byLanguage[f.language] || 0) + 1;
+    totalSize += f.size;
+  }
+  const topExporters = index.files.filter(f => f.exports.length > 0).sort((a, b) => b.exports.length - a.exports.length).slice(0, 20).map(f => ({
+    path: f.path,
+    count: f.exports.length
+  }));
+  return {
+    totalFiles: index.files.length,
+    totalSize,
+    byLanguage,
+    topExporters
+  };
+}
+//# sourceMappingURL=project-index.js.map

package/dist/cli/services/project-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-index.js","names":["existsSync","readFileSync","writeFileSync","mkdirSync","statSync","readdirSync","join","relative","extname","homedir","INDEX_VERSION","INDEX_DIR","INDEX_FILE","LANG_MAP","IGNORE_DIRS","Set","IGNORE_EXTENSIONS","MAX_FILES","MAX_FILE_SIZE_FOR_EXPORTS","EXPORT_PATTERNS","typescript","javascript","python","go","rust","swift","extractExports","content","language","patterns","exports","pattern","lastIndex","match","exec","name","trim","startsWith","add","Array","from","sort","walkDirectory","root","maxFiles","results","walk","dir","depth","length","entries","entry","fullPath","stat","isDirectory","has","isFile","ext","toLowerCase","size","push","path","mtime","mtimeMs","getIndexPath","projectRoot","hash","i","charCodeAt","Math","abs","toString","buildFileEntry","fileMeta","slice","buildIndex","fileMetas","files","map","fm","version","updatedAt","Date","toISOString","refreshIndex","existing","existingMap","Map","f","prev","get","loadIndex","indexPath","raw","JSON","parse","saveIndex","index","recursive","stringify","getOrRefreshIndex","findExportingFiles","symbolName","filter","includes","findByLanguage","findByPath","lower","getProjectStats","byLanguage","totalSize","topExporters","a","b","count","totalFiles"],"sources":["../../../src/cli/services/project-index.ts"],"sourcesContent":["/**\n * Project Index — lightweight file map cached in .whale/index.json.\n *\n * On first query: walks the project tree, records metadata per file.\n * On subsequent sessions: refreshes incrementally via mtime checks.\n * Used for: \"which files handle X?\" queries, smarter glob suggestions, context awareness.\n */\n\nimport { existsSync, readFileSync, writeFileSync, mkdirSync, statSync, readdirSync } from \"fs\";\nimport { join, relative, extname, basename, dirname } from \"path\";\nimport { homedir } from \"os\";\n\n// ============================================================================\n// TYPES\n// ============================================================================\n\nexport interface FileEntry {\n  path: string;          // Relative to project root\n  size: number;          // Bytes\n  mtime: number;         // ms since epoch\n  language: string;      // Detected from extension\n  exports: string[];     // Top-level exports (functions, classes, types)\n}\n\nexport interface ProjectIndex {\n  root: string;\n  version: number;\n  updatedAt: string;\n  files: FileEntry[];\n}\n\n// ============================================================================\n// CONSTANTS\n// ============================================================================\n\nconst INDEX_VERSION = 1;\nconst INDEX_DIR = join(homedir(), \".whale\");\nconst INDEX_FILE = \"index.json\";\n\nconst LANG_MAP: Record<string, string> = {\n  \".ts\": \"typescript\", \".tsx\": \"typescript\", \".js\": \"javascript\", \".jsx\": \"javascript\",\n  \".mjs\": \"javascript\", \".cjs\": \"javascript\",\n  \".py\": \"python\", \".rb\": \"ruby\", \".go\": \"go\", \".rs\": \"rust\",\n  \".java\": \"java\", \".kt\": \"kotlin\", \".scala\": \"scala\",\n  \".swift\": \"swift\", \".m\": \"objc\", \".mm\": \"objc\",\n  \".c\": \"c\", \".h\": \"c\", \".cpp\": \"cpp\", \".hpp\": \"cpp\", \".cc\": \"cpp\",\n  \".cs\": \"csharp\", \".php\": \"php\", \".lua\": \"lua\", \".r\": \"r\",\n  \".sql\": \"sql\", \".sh\": \"shell\", \".bash\": \"shell\", \".zsh\": \"shell\",\n  \".json\": \"json\", \".yaml\": \"yaml\", \".yml\": \"yaml\", \".toml\": \"toml\",\n  \".xml\": \"xml\", \".html\": \"html\", \".css\": \"css\", \".scss\": \"scss\",\n  \".md\": \"markdown\", \".mdx\": \"markdown\",\n};\n\nconst IGNORE_DIRS = new Set([\n  \"node_modules\", \".git\", \".svn\", \".hg\", \"dist\", \"build\", \"out\",\n  \".next\", \".nuxt\", \".cache\", \".turbo\", \".parcel-cache\",\n  \"__pycache__\", \".pytest_cache\", \"venv\", \".venv\",\n  \"target\", \"Pods\", \"DerivedData\", \".build\",\n  \"coverage\", \".nyc_output\",\n]);\n\nconst IGNORE_EXTENSIONS = new Set([\n  \".map\", \".min.js\", \".min.css\", \".lock\", \".log\",\n  \".png\", \".jpg\", \".jpeg\", \".gif\", \".ico\", \".svg\", \".webp\",\n  \".woff\", \".woff2\", \".ttf\", \".eot\",\n  \".mp3\", \".mp4\", \".wav\", \".avi\", \".mov\",\n  \".zip\", \".tar\", \".gz\", \".bz2\", \".7z\",\n  \".exe\", \".dll\", \".so\", \".dylib\", \".o\", \".a\",\n  \".pyc\", \".pyo\", \".class\",\n]);\n\nconst MAX_FILES = 5000;\nconst MAX_FILE_SIZE_FOR_EXPORTS = 500_000; // 500KB\n\n// ============================================================================\n// EXPORT EXTRACTION (lightweight, regex-based)\n// ============================================================================\n\nconst EXPORT_PATTERNS: Record<string, RegExp[]> = {\n  typescript: [\n    /^export\\s+(?:async\\s+)?function\\s+(\\w+)/gm,\n    /^export\\s+class\\s+(\\w+)/gm,\n    /^export\\s+(?:const|let|var)\\s+(\\w+)/gm,\n    /^export\\s+type\\s+(\\w+)/gm,\n    /^export\\s+interface\\s+(\\w+)/gm,\n    /^export\\s+enum\\s+(\\w+)/gm,\n    /^export\\s+default\\s+(?:function|class)\\s+(\\w+)/gm,\n  ],\n  javascript: [\n    /^export\\s+(?:async\\s+)?function\\s+(\\w+)/gm,\n    /^export\\s+class\\s+(\\w+)/gm,\n    /^export\\s+(?:const|let|var)\\s+(\\w+)/gm,\n    /^export\\s+default\\s+(?:function|class)\\s+(\\w+)/gm,\n    /^module\\.exports\\s*=\\s*\\{\\s*([^}]+)\\}/gm,\n  ],\n  python: [\n    /^def\\s+(\\w+)\\s*\\(/gm,\n    /^class\\s+(\\w+)/gm,\n    /^(\\w+)\\s*=\\s*/gm,\n  ],\n  go: [\n    /^func\\s+(\\w+)/gm,\n    /^type\\s+(\\w+)\\s+(?:struct|interface)/gm,\n  ],\n  rust: [\n    /^pub\\s+(?:async\\s+)?fn\\s+(\\w+)/gm,\n    /^pub\\s+struct\\s+(\\w+)/gm,\n    /^pub\\s+enum\\s+(\\w+)/gm,\n    /^pub\\s+trait\\s+(\\w+)/gm,\n  ],\n  swift: [\n    /^(?:public\\s+|open\\s+)?func\\s+(\\w+)/gm,\n    /^(?:public\\s+|open\\s+)?class\\s+(\\w+)/gm,\n    /^(?:public\\s+|open\\s+)?struct\\s+(\\w+)/gm,\n    /^(?:public\\s+|open\\s+)?enum\\s+(\\w+)/gm,\n    /^(?:public\\s+|open\\s+)?protocol\\s+(\\w+)/gm,\n  ],\n};\n\nfunction extractExports(content: string, language: string): string[] {\n  const patterns = EXPORT_PATTERNS[language];\n  if (!patterns) return [];\n\n  const exports = new Set<string>();\n  for (const pattern of patterns) {\n    pattern.lastIndex = 0;\n    let match;\n    while ((match = pattern.exec(content)) !== null) {\n      const name = match[1]?.trim();\n      if (name && !name.startsWith(\"_\")) {\n        exports.add(name);\n      }\n    }\n  }\n  return Array.from(exports).sort();\n}\n\n// ============================================================================\n// DIRECTORY WALKER\n// ============================================================================\n\nfunction walkDirectory(root: string, maxFiles: number): Array<{ path: string; size: number; mtime: number }> {\n  const results: Array<{ path: string; size: number; mtime: number }> = [];\n\n  function walk(dir: string, depth: number) {\n    if (results.length >= maxFiles || depth > 15) return;\n\n    let entries: string[];\n    try {\n      entries = readdirSync(dir);\n    } catch {\n      return;\n    }\n\n    for (const entry of entries) {\n      if (results.length >= maxFiles) return;\n      if (entry.startsWith(\".\") && entry !== \".github\") continue;\n\n      const fullPath = join(dir, entry);\n      let stat;\n      try {\n        stat = statSync(fullPath);\n      } catch {\n        continue;\n      }\n\n      if (stat.isDirectory()) {\n        if (!IGNORE_DIRS.has(entry)) {\n          walk(fullPath, depth + 1);\n        }\n      } else if (stat.isFile()) {\n        const ext = extname(entry).toLowerCase();\n        if (IGNORE_EXTENSIONS.has(ext)) continue;\n        if (stat.size > 10_000_000) continue; // Skip files > 10MB\n\n        results.push({\n          path: relative(root, fullPath),\n          size: stat.size,\n          mtime: stat.mtimeMs,\n        });\n      }\n    }\n  }\n\n  walk(root, 0);\n  return results;\n}\n\n// ============================================================================\n// INDEX BUILD / REFRESH\n// ============================================================================\n\nfunction getIndexPath(projectRoot: string): string {\n  // Hash the project root to create a unique index file per project\n  let hash = 0;\n  for (let i = 0; i < projectRoot.length; i++) {\n    hash = ((hash << 5) - hash + projectRoot.charCodeAt(i)) | 0;\n  }\n  return join(INDEX_DIR, `index-${Math.abs(hash).toString(36)}.json`);\n}\n\nfunction buildFileEntry(root: string, fileMeta: { path: string; size: number; mtime: number }): FileEntry {\n  const ext = extname(fileMeta.path).toLowerCase();\n  const language = LANG_MAP[ext] || ext.slice(1) || \"unknown\";\n\n  let exports: string[] = [];\n  if (fileMeta.size <= MAX_FILE_SIZE_FOR_EXPORTS && EXPORT_PATTERNS[language]) {\n    try {\n      const content = readFileSync(join(root, fileMeta.path), \"utf-8\");\n      exports = extractExports(content, language);\n    } catch {\n      // File unreadable — skip exports\n    }\n  }\n\n  return {\n    path: fileMeta.path,\n    size: fileMeta.size,\n    mtime: fileMeta.mtime,\n    language,\n    exports,\n  };\n}\n\nexport function buildIndex(projectRoot: string): ProjectIndex {\n  const fileMetas = walkDirectory(projectRoot, MAX_FILES);\n  const files = fileMetas.map(fm => buildFileEntry(projectRoot, fm));\n\n  return {\n    root: projectRoot,\n    version: INDEX_VERSION,\n    updatedAt: new Date().toISOString(),\n    files,\n  };\n}\n\nexport function refreshIndex(existing: ProjectIndex, projectRoot: string): ProjectIndex {\n  const fileMetas = walkDirectory(projectRoot, MAX_FILES);\n  const existingMap = new Map(existing.files.map(f => [f.path, f]));\n  const files: FileEntry[] = [];\n\n  for (const fm of fileMetas) {\n    const prev = existingMap.get(fm.path);\n    if (prev && Math.abs(prev.mtime - fm.mtime) < 1) {\n      // Unchanged — reuse existing entry\n      files.push(prev);\n    } else {\n      // New or modified — rebuild\n      files.push(buildFileEntry(projectRoot, fm));\n    }\n  }\n\n  return {\n    root: projectRoot,\n    version: INDEX_VERSION,\n    updatedAt: new Date().toISOString(),\n    files,\n  };\n}\n\n// ============================================================================\n// LOAD / SAVE\n// ============================================================================\n\nexport function loadIndex(projectRoot: string): ProjectIndex | null {\n  const indexPath = getIndexPath(projectRoot);\n  if (!existsSync(indexPath)) return null;\n\n  try {\n    const raw = JSON.parse(readFileSync(indexPath, \"utf-8\")) as ProjectIndex;\n    if (raw.version !== INDEX_VERSION || raw.root !== projectRoot) return null;\n    return raw;\n  } catch {\n    return null;\n  }\n}\n\nexport function saveIndex(index: ProjectIndex): void {\n  const indexPath = getIndexPath(index.root);\n  try {\n    if (!existsSync(INDEX_DIR)) mkdirSync(INDEX_DIR, { recursive: true });\n    writeFileSync(indexPath, JSON.stringify(index), \"utf-8\");\n  } catch {\n    // Non-critical — index is a cache\n  }\n}\n\n// ============================================================================\n// QUERY HELPERS\n// ============================================================================\n\nexport function getOrRefreshIndex(projectRoot: string): ProjectIndex {\n  const existing = loadIndex(projectRoot);\n  let index: ProjectIndex;\n  if (existing) {\n    index = refreshIndex(existing, projectRoot);\n  } else {\n    index = buildIndex(projectRoot);\n  }\n  saveIndex(index);\n  return index;\n}\n\n/** Find files that export a given symbol name. */\nexport function findExportingFiles(index: ProjectIndex, symbolName: string): FileEntry[] {\n  return index.files.filter(f => f.exports.includes(symbolName));\n}\n\n/** Find files by language. */\nexport function findByLanguage(index: ProjectIndex, language: string): FileEntry[] {\n  return index.files.filter(f => f.language === language);\n}\n\n/** Find files matching a path pattern (simple substring match). */\nexport function findByPath(index: ProjectIndex, pattern: string): FileEntry[] {\n  const lower = pattern.toLowerCase();\n  return index.files.filter(f => f.path.toLowerCase().includes(lower));\n}\n\n/** Get summary stats for the project. */\nexport function getProjectStats(index: ProjectIndex): {\n  totalFiles: number;\n  totalSize: number;\n  byLanguage: Record<string, number>;\n  topExporters: Array<{ path: string; count: number }>;\n} {\n  const byLanguage: Record<string, number> = {};\n  let totalSize = 0;\n\n  for (const f of index.files) {\n    byLanguage[f.language] = (byLanguage[f.language] || 0) + 1;\n    totalSize += f.size;\n  }\n\n  const topExporters = index.files\n    .filter(f => f.exports.length > 0)\n    .sort((a, b) => b.exports.length - a.exports.length)\n    .slice(0, 20)\n    .map(f => ({ path: f.path, count: f.exports.length }));\n\n  return { totalFiles: index.files.length, totalSize, byLanguage, topExporters };\n}\n"],"mappings":"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","ignoreList":[]}

package/dist/cli/services/rewind-rewindTo.test.js

@@ -0,0 +1,202 @@
+/**
+ * Tests for RewindManager — rewindTo and revertFilesFrom
+ */
+
+import { describe, it, expect, beforeEach, vi, afterEach } from "vitest";
+import { RewindManager } from "./rewind.js";
+import { existsSync, readFileSync, writeFileSync, unlinkSync } from "fs";
+
+// Mock fs operations
+vi.mock("fs", () => ({
+  existsSync: vi.fn(),
+  readFileSync: vi.fn(),
+  writeFileSync: vi.fn(),
+  unlinkSync: vi.fn()
+}));
+const mockExistsSync = existsSync;
+const mockReadFileSync = readFileSync;
+const mockWriteFileSync = writeFileSync;
+const mockUnlinkSync = unlinkSync;
+describe("RewindManager", () => {
+  let manager;
+  beforeEach(() => {
+    manager = new RewindManager();
+    vi.clearAllMocks();
+  });
+  afterEach(() => {
+    vi.restoreAllMocks();
+  });
+  describe("rewindTo", () => {
+    it("should return error for invalid index", () => {
+      const result = manager.rewindTo(5);
+      expect(result.errors).toHaveLength(1);
+      expect(result.errors[0]).toContain("Invalid checkpoint index");
+    });
+    it("should truncate checkpoints and return correct messageCount", () => {
+      manager.addCheckpoint(0, 2, "Turn 1", []);
+      manager.addCheckpoint(1, 5, "Turn 2", []);
+      manager.addCheckpoint(2, 8, "Turn 3", []);
+      const result = manager.rewindTo(0);
+      expect(result.messageCount).toBe(2);
+      expect(manager.getCheckpoints()).toHaveLength(1);
+    });
+    it("should restore edited files from backup", () => {
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockReturnValue(Buffer.from("original content"));
+      manager.addCheckpoint(0, 2, "Turn 1", []);
+      manager.addCheckpoint(1, 5, "Turn 2", [{
+        filePath: "/src/foo.ts",
+        backupPath: "/backup/123-foo.ts",
+        operation: "edit",
+        isNewFile: false
+      }]);
+      const result = manager.rewindTo(0);
+      expect(result.filesReverted).toContain("/src/foo.ts");
+      expect(mockReadFileSync).toHaveBeenCalledWith("/backup/123-foo.ts");
+      expect(mockWriteFileSync).toHaveBeenCalledWith("/src/foo.ts", Buffer.from("original content"));
+    });
+    it("should delete files that were created during reverted turns", () => {
+      mockExistsSync.mockReturnValue(true);
+      manager.addCheckpoint(0, 2, "Turn 1", []);
+      manager.addCheckpoint(1, 5, "Turn 2", [{
+        filePath: "/src/new-file.ts",
+        backupPath: "",
+        operation: "write",
+        isNewFile: true
+      }]);
+      const result = manager.rewindTo(0);
+      expect(result.filesDeleted).toContain("/src/new-file.ts");
+      expect(mockUnlinkSync).toHaveBeenCalledWith("/src/new-file.ts");
+    });
+    it("should handle multiple checkpoints with file changes", () => {
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockReturnValue(Buffer.from("original"));
+      manager.addCheckpoint(0, 2, "Turn 1", []);
+      manager.addCheckpoint(1, 5, "Turn 2", [{
+        filePath: "/src/a.ts",
+        backupPath: "/backup/a.ts",
+        operation: "edit",
+        isNewFile: false
+      }]);
+      manager.addCheckpoint(2, 8, "Turn 3", [{
+        filePath: "/src/b.ts",
+        backupPath: "",
+        operation: "write",
+        isNewFile: true
+      }, {
+        filePath: "/src/c.ts",
+        backupPath: "/backup/c.ts",
+        operation: "multi_edit",
+        isNewFile: false
+      }]);
+      const result = manager.rewindTo(0);
+      expect(result.filesReverted).toHaveLength(2); // a.ts and c.ts
+      expect(result.filesDeleted).toHaveLength(1); // b.ts
+      expect(manager.getCheckpoints()).toHaveLength(1);
+    });
+    it("should report error when backup file is missing", () => {
+      mockExistsSync.mockImplementation(path => {
+        // File exists but backup does not
+        return path === "/src/foo.ts";
+      });
+      manager.addCheckpoint(0, 2, "Turn 1", []);
+      manager.addCheckpoint(1, 5, "Turn 2", [{
+        filePath: "/src/foo.ts",
+        backupPath: "/backup/missing.ts",
+        operation: "edit",
+        isNewFile: false
+      }]);
+      const result = manager.rewindTo(0);
+      expect(result.errors).toHaveLength(1);
+      expect(result.errors[0]).toContain("No backup found");
+    });
+    it("should handle fs errors gracefully", () => {
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockImplementation(() => {
+        throw new Error("Permission denied");
+      });
+      manager.addCheckpoint(0, 2, "Turn 1", []);
+      manager.addCheckpoint(1, 5, "Turn 2", [{
+        filePath: "/src/foo.ts",
+        backupPath: "/backup/foo.ts",
+        operation: "edit",
+        isNewFile: false
+      }]);
+      const result = manager.rewindTo(0);
+      expect(result.errors).toHaveLength(1);
+      expect(result.errors[0]).toContain("Permission denied");
+    });
+    it("should clear pending file changes on rewind", () => {
+      manager.addCheckpoint(0, 2, "Turn 1", []);
+      manager.trackFileChange({
+        filePath: "/src/test.ts",
+        backupPath: "/backup/test.ts",
+        operation: "edit",
+        isNewFile: false
+      });
+      manager.rewindTo(0);
+      expect(manager.getCurrentFileChanges()).toHaveLength(0);
+    });
+    it("should deduplicate reverted file paths", () => {
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockReturnValue(Buffer.from("original"));
+      manager.addCheckpoint(0, 2, "Turn 1", []);
+      manager.addCheckpoint(1, 5, "Turn 2", [{
+        filePath: "/src/foo.ts",
+        backupPath: "/backup/1-foo.ts",
+        operation: "edit",
+        isNewFile: false
+      }]);
+      manager.addCheckpoint(2, 8, "Turn 3", [{
+        filePath: "/src/foo.ts",
+        backupPath: "/backup/2-foo.ts",
+        operation: "edit",
+        isNewFile: false
+      }]);
+      const result = manager.rewindTo(0);
+      expect(result.filesReverted).toHaveLength(1); // deduplicated
+    });
+    it("should process checkpoints in reverse chronological order", () => {
+      const callOrder = [];
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockImplementation(path => {
+        callOrder.push(path);
+        return Buffer.from("content");
+      });
+      manager.addCheckpoint(0, 2, "Turn 1", []);
+      manager.addCheckpoint(1, 5, "Turn 2", [{
+        filePath: "/src/a.ts",
+        backupPath: "/backup/turn2.ts",
+        operation: "edit",
+        isNewFile: false
+      }]);
+      manager.addCheckpoint(2, 8, "Turn 3", [{
+        filePath: "/src/b.ts",
+        backupPath: "/backup/turn3.ts",
+        operation: "edit",
+        isNewFile: false
+      }]);
+      manager.rewindTo(0);
+      // Turn 3 should be processed before Turn 2 (reverse chronological)
+      expect(callOrder[0]).toBe("/backup/turn3.ts");
+      expect(callOrder[1]).toBe("/backup/turn2.ts");
+    });
+  });
+  describe("revertFilesFrom", () => {
+    it("should revert files without truncating checkpoints", () => {
+      mockExistsSync.mockReturnValue(true);
+      mockReadFileSync.mockReturnValue(Buffer.from("original"));
+      manager.addCheckpoint(0, 2, "Turn 1", []);
+      manager.addCheckpoint(1, 5, "Turn 2", [{
+        filePath: "/src/foo.ts",
+        backupPath: "/backup/foo.ts",
+        operation: "edit",
+        isNewFile: false
+      }]);
+      const result = manager.revertFilesFrom(0);
+      expect(result.filesReverted).toContain("/src/foo.ts");
+      // Checkpoints should NOT be truncated
+      expect(manager.getCheckpoints()).toHaveLength(2);
+    });
+  });
+});