@takara-ai/miru-code 0.7.0 → 0.8.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@takara-ai/miru-code",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Miru (見る) — hybrid code search for agents. Bun, TypeScript, Takara embeddings.",
   "type": "module",
   "license": "MIT",

package/src/cache.ts

@@ -13,8 +13,13 @@ import { resolveSemanticStorage, semanticStorageFromMetadata } from "./index/vec
 import type { Chunk, ContentType } from "./types.ts";
 import { chunkFromDict } from "./types.ts";
 import { computeSourceCacheKey } from "./utils.ts";
+import { indexCacheEpoch } from "./version.ts";
 
 export function resolveCacheFolder(): string {
+  const override = process.env.MIRU_CACHE_HOME?.trim();
+  if (override) {
+    return override;
+  }
   const name = "miru";
   const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
   let base: string;
@@ -43,6 +48,9 @@ function metadataMatches(
   content: ContentType[],
 ): boolean {
   try {
+    if (metadata.index_epoch !== indexCacheEpoch()) {
+      return false;
+    }
     const stored = metadata.content_type as ContentType[];
     const model = metadata.embedding_model as string;
     if (model !== embeddingModel) {
@@ -87,6 +95,9 @@ export async function getValidatedCache(
   const model = embeddingModel ?? resolveEmbeddingModel();
   const metadata = JSON.parse(await Bun.file(paths.metadata).text()) as Record<string, unknown>;
   if (!metadataMatches(metadata, model, content)) {
+    if (metadata.index_epoch !== indexCacheEpoch()) {
+      await rm(indexPath, { recursive: true, force: true });
+    }
     return null;
   }
 

package/src/miru-index.ts

@@ -17,6 +17,7 @@ import { hybridSearch, searchSemanticOnly } from "./search.ts";
 import type { Chunk, ContentType, SearchResult } from "./types.ts";
 import { chunkKey, chunkToDict } from "./types.ts";
 import { computeSourceCacheKey, isGitUrl } from "./utils.ts";
+import { indexCacheEpoch } from "./version.ts";
 
 export class MiruIndex {
   readonly embeddings: EmbeddingBackend;
@@ -204,6 +205,7 @@ export class MiruIndex {
       semantic: this.semanticIndex,
       chunks: this.chunks.map(chunkToDict),
       metadata: {
+        index_epoch: indexCacheEpoch(),
         root_path: this.root,
         time: Date.now() / 1000,
         embedding_model: this.embeddingModel,

package/src/version.ts

@@ -19,6 +19,21 @@ export function miruVersion(): string {
   return packageJson.version;
 }
 
+/**
+ * Index cache epoch — zero-copy from package.json semver.
+ * - 0.x releases: `0.{minor}` (chunking may break on minor bumps pre-1.0).
+ * - 1.x+: major version only.
+ */
+export function indexCacheEpoch(): string {
+  const parts = packageJson.version.split(".");
+  const major = parts[0] ?? "0";
+  const minor = parts[1] ?? "0";
+  if (major === "0") {
+    return `0.${minor}`;
+  }
+  return major;
+}
+
 export function isVersionNewer(latest: string, current: string): boolean {
   const parse = (v: string): [number, number, number] | null => {
     const match = v.trim().match(/^(\d+)\.(\d+)\.(\d+)/);