rag-memory-epf-mcp 6.4.3 → 6.4.4

package/README.md

@@ -154,6 +154,24 @@ storeDocument(id, content, metadata)
 
 ## Changelog
 
+### v6.4.4 (2026-11-07)
+
+- **Fixed — the similarity numbers are real cosine similarities.** The vec0 tables use the default L2 metric and the
+  embeddings are unit-normalized, so cosine similarity = 1 − d²/2. The engine used 1 − d/2 (L2 read as a cosine
+  distance): `searchNodes` `similarity` and the default `hybridSearch` `vector_similarity` were too low above cos 0.5
+  (cos 0.8 showed ≈0.684) and too high below it (orthogonal vectors showed ≈0.293 instead of 0). Ranking of the default
+  search is unchanged (rank fusion uses ranks only).
+- **Unchanged on purpose — the legacy paths keep the 6.3.2 score.** `hybridSearch` with `useGraph: true` or with
+  summaries on, and the graph-seed threshold (`> 0.4`, about cosine 0.28), stay byte-identical to 6.3.2 for evaluation
+  comparability; that score is named `legacyL2AsCosineScore` and is not a cosine.
+- **Fixed — chunk vectors without metadata are cleaned up.** Reconciliation now deletes searchable chunk vectors that
+  have no `chunk_metadata` row (same rule and batching as entity orphans; off mode only classifies it as deferred).
+  `importGraph` no longer creates them: a full replace (`merge: false`) and a same-id document replace delete that
+  document's chunk vectors first. Rowids past 2^53 are kept exact.
+- **Added — `getKnowledgeGraphStats().server.coverage.{chunk,entity}.orphan_vectors`**: searchable vectors with no
+  metadata row (`null` when the slot map cannot be resolved). `missing` keeps its meaning.
+- Not measured: Windows, Drive-synced DBs under two machines.
+
 ### v6.4.3 (2026-11-02)
 
 - **Fixed — re-embedding no longer leaks vector slots.** sqlite-vec puts a new row only into a free slot of the latest

package/dist/index.d.ts

@@ -489,7 +489,7 @@ export declare class RAGKnowledgeGraphManager {
     }>;
     /**
      * Diagnostic seam for the graph re-ranker (evaluation change graph-role-evaluation, R2).
-     * Returns the seed entities (query-vector matched, similarity > 0.4, top-10 per variant) and the
+     * Returns the seed entities (query-vector matched, legacy score > 0.4 = cosine ≈0.28, top-10 per variant) and the
      * 1-hop connected entities exactly as hybridSearch(useGraph:true) computes them, plus edge detail
      * that hybridSearch itself does not use (edge id, type, direction, confidence). It never generates
      * candidates and never changes ranking; hybridSearch consumes only the name sets.

package/dist/index.js

@@ -34,6 +34,7 @@ import { migrations } from './src/migrations/migrations.js';
 import { EmbeddingGate, GateNotReadyError, GateDisabledError, TerminalConfigError } from './src/embeddingGate.js';
 import { resolveModelCacheDir, preflightCacheDir, artifactKey, ModelDownloadLock, handleLoaderFailure } from './src/modelCache.js';
 import { BackfillCoordinator } from './src/backfillCoordinator.js';
+import { l2ToCosineSimilarity, legacyL2AsCosineScore } from './src/vecSimilarity.js';
 import { writeVector, deleteVector, registerVecSlotFunctions, InvalidSlotError, slotSummary, rebuildVecTable, rebuildReason, DEFAULT_REBUILD_POLICY } from './src/vecSlots.js';
 import { calendarDate, resolveCalendarTimeZone, stampDatePrefix, stripDatePrefix } from './src/observations/date-prefix.js';
 import os from 'node:os';
@@ -1894,7 +1895,7 @@ export class RAGKnowledgeGraphManager {
             name: result.name,
             entityType: result.entityType,
             observations: JSON.parse(result.observations),
-            similarity: Math.max(0, 1 - result.distance / 2) // Convert cosine distance (0-2) to similarity (1-0)
+            similarity: l2ToCosineSimilarity(result.distance) // vec0 L2 distance of unit vectors -> cosine similarity
         }));
         // hybrid-partial (spec §4): entities without vectors must not vanish from
         // search while backfill catches up — merge lexical FTS hits for the gap.
@@ -3665,12 +3666,18 @@ export class RAGKnowledgeGraphManager {
                 this.db.exec(`DELETE FROM entity_observations`);
                 this.db.exec(`DELETE FROM observation_roots`);
                 this.db.exec(`DELETE FROM entities`);
+                // documents → chunk_metadata is a CASCADE, but vec0 has no FK: delete the document chunk vectors first,
+                // or they stay searchable-less orphans (IN-42 · same order as storeDocument's replace path).
+                // rowids stay BigInt end to end (2_ r1 R1: a Number cast past 2^53 deletes the wrong vector)
+                for (const c of this.db.prepare(`SELECT rowid FROM chunk_metadata WHERE document_id IS NOT NULL`).safeIntegers(true).all()) {
+                    deleteVector(this.db, 'chunks', c.rowid);
+                }
                 this.db.exec(`DELETE FROM documents`);
                 // entities 를 지워도 파생 데이터는 따라오지 않는다: chunk_metadata 에는
                 // entities 로 가는 FK 가 없고 entity_embedding_metadata.entity_id 는 UNIQUE 일
                 // 뿐이다. 그래서 replace-import 뒤에 **사라진 entity 의 벡터와 KG chunk 가
-                // 검색에 남았다**(advisor beta 발견 2). document chunk 는 documents 의
-                // CASCADE 로 이미 정리되므로 여기서는 entity·relationship chunk 만 지운다.
+                // 검색에 남았다**(advisor beta 발견 2). document chunk 메타는 documents 의
+                // CASCADE 로 정리되고 그 벡터는 위에서 먼저 지웠다(IN-42) — 여기서는 entity·relationship chunk 만 지운다.
                 const orphanChunks = this.db.prepare(`SELECT rowid FROM chunk_metadata WHERE chunk_type IN ('entity','relationship')`)
                     .all();
                 for (const c of orphanChunks) {
@@ -3732,6 +3739,10 @@ export class RAGKnowledgeGraphManager {
                     // doc.id is a string here (checked above, before any write).
                     for (const r of collectEvidenceRowidsCitingDocument(this.db, doc.id))
                         citedEvidence.add(r);
+                    // REPLACE deletes an existing row → its chunk_metadata goes by CASCADE, the vec0 vectors would not (IN-42).
+                    for (const c of this.db.prepare(`SELECT rowid FROM chunk_metadata WHERE document_id = ?`).safeIntegers(true).all(doc.id)) {
+                        deleteVector(this.db, 'chunks', c.rowid);
+                    }
                     const result = stmt.run(doc.id, doc.content, JSON.stringify(doc.metadata || {}), doc.created_at || new Date().toISOString());
                     if (result.changes > 0) {
                         imported.documents++;
@@ -3901,7 +3912,7 @@ export class RAGKnowledgeGraphManager {
     }
     /**
      * Diagnostic seam for the graph re-ranker (evaluation change graph-role-evaluation, R2).
-     * Returns the seed entities (query-vector matched, similarity > 0.4, top-10 per variant) and the
+     * Returns the seed entities (query-vector matched, legacy score > 0.4 = cosine ≈0.28, top-10 per variant) and the
      * 1-hop connected entities exactly as hybridSearch(useGraph:true) computes them, plus edge detail
      * that hybridSearch itself does not use (edge id, type, direction, confidence). It never generates
      * candidates and never changes ranking; hybridSearch consumes only the name sets.
@@ -3953,7 +3964,7 @@ export class RAGKnowledgeGraphManager {
             WHERE r.source_entity = ? OR r.target_entity = ?
             ORDER BY r.id`);
             for (const entity of similar) {
-                const similarity = Math.max(0, 1 - entity.distance / 2);
+                const similarity = legacyL2AsCosineScore(entity.distance); // legacy seed score, pinned (4ac3155) — not a cosine
                 if (similarity > 0.4) {
                     seeds.push({ entity_id: entity.entity_id, name: entity.name, similarity });
                     for (const row of edgeStmt.all(entity.entity_id, entity.entity_id, entity.entity_id, entity.entity_id, entity.entity_id)) {
@@ -4300,7 +4311,8 @@ export class RAGKnowledgeGraphManager {
                 ({ summary, keyHighlight, relevanceScore } = await this.generateContentSummary(result.text, primaryQueryEmbedding, chunkEntities, result.chunk_type === 'relationship' ? 1 : 2 // Shorter summary for relationships
                 ));
             }
-            const vectorSimilarity = Math.max(0, 1 - result.distance / 2);
+            // default (rank fusion) = real cosine · legacy paths (useGraph:true or summaries on) keep the pinned 6.3.2 score
+            const vectorSimilarity = rankFusion ? l2ToCosineSimilarity(result.distance) : legacyL2AsCosineScore(result.distance);
             const ftsBoost = ftsBoostMap.get(result.chunk_id) || 0; // = 1/(60 + FTS rank), 0 if not an FTS hit
             const vectorRank = vectorRankOf.get(result.chunk_id);
             const finalScore = rankFusion
@@ -4566,11 +4578,11 @@ export class RAGKnowledgeGraphManager {
                 coverage: cov ? {
                     // vec-slot-reuse D1c: an unresolvable slot map is reported as error with missing = null, not as a count.
                     chunk: cov.chunk.error
-                        ? { total: cov.chunk.total, embedded: null, verified: null, legacy_assumed: null, missing: null, error: cov.chunk.error }
-                        : { total: cov.chunk.total, embedded: cov.chunk.embedded, verified: cov.chunk.verified, legacy_assumed: cov.chunk.legacy_assumed, missing: cov.chunk.total - cov.chunk.embedded },
+                        ? { total: cov.chunk.total, embedded: null, verified: null, legacy_assumed: null, missing: null, orphan_vectors: null, error: cov.chunk.error }
+                        : { total: cov.chunk.total, embedded: cov.chunk.embedded, verified: cov.chunk.verified, legacy_assumed: cov.chunk.legacy_assumed, missing: cov.chunk.total - cov.chunk.embedded, orphan_vectors: cov.chunk.orphan_vectors ?? null },
                     entity: cov.entity.error
-                        ? { total: cov.entity.total, embedded: null, verified: null, legacy_assumed: null, missing: null, error: cov.entity.error }
-                        : { total: cov.entity.total, embedded: cov.entity.embedded, verified: cov.entity.verified, legacy_assumed: cov.entity.legacy_assumed, missing: cov.entity.total - cov.entity.embedded },
+                        ? { total: cov.entity.total, embedded: null, verified: null, legacy_assumed: null, missing: null, orphan_vectors: null, error: cov.entity.error }
+                        : { total: cov.entity.total, embedded: cov.entity.embedded, verified: cov.entity.verified, legacy_assumed: cov.entity.legacy_assumed, missing: cov.entity.total - cov.entity.embedded, orphan_vectors: cov.entity.orphan_vectors ?? null },
                 } : null,
                 // vec-slot-reuse: per vec0 table = slots, searchable, validity-0 rows, reclaimable chunks, why a rebuild
                 // is (not) due, and the last attempt of this process. Read-only: computing it writes nothing.

package/dist/src/backfillCoordinator.d.ts

@@ -6,6 +6,7 @@ export interface CoverageSnapshot {
         embedded: number;
         verified: number;
         legacy_assumed: number;
+        orphan_vectors?: number;
         error?: string;
     };
     entity: {
@@ -13,6 +14,7 @@ export interface CoverageSnapshot {
         embedded: number;
         verified: number;
         legacy_assumed: number;
+        orphan_vectors?: number;
         error?: string;
     };
 }

package/dist/src/backfillCoordinator.js

@@ -92,6 +92,8 @@ export class BackfillCoordinator {
             // vec-slot-reuse r3 M2: searchable orphans only (validity-0 rows belong to the rebuild); vectorless
             // metadata counts only while still stamped (it is normalized to missing, not deleted, to keep its rowid).
             + q(`SELECT COUNT(*) c FROM entity_embeddings_rowids m WHERE m.rowid NOT IN (SELECT rowid FROM entity_embedding_metadata) AND ${searchableVectorSql('entity_embeddings', 'm.rowid')}`)
+            // IN-42: searchable chunk vectors without chunk_metadata (same rule as entity orphans)
+            + q(`SELECT COUNT(*) c FROM chunks_rowids m WHERE m.rowid NOT IN (SELECT rowid FROM chunk_metadata) AND ${searchableVectorSql('chunks', 'm.rowid')}`)
             + q(`SELECT COUNT(*) c FROM entity_embedding_metadata WHERE provenance_state IS NOT NULL AND rowid NOT IN (SELECT rowid FROM entity_embeddings_rowids)`)
             + q(`SELECT COUNT(*) c FROM entity_embedding_metadata WHERE provenance_state IS NOT NULL AND profile_id IS NOT ?`, profileId)
             + q(`SELECT COUNT(*) c FROM chunk_metadata m WHERE m.provenance_state IS NOT NULL AND m.profile_id IS NOT ? AND m.rowid IN (SELECT rowid FROM chunks_rowids)`, profileId)
@@ -136,6 +138,22 @@ export class BackfillCoordinator {
                 break;
             await new Promise(r => setImmediate(r));
         }
+        // 1b. searchable chunk vectors without metadata -> delete (IN-42 · same batching and validity rule as 1)
+        for (;;) {
+            if (this.shuttingDown)
+                throw new Error('shutdown during sanitation');
+            const orphans = db.prepare(`SELECT m.rowid FROM chunks_rowids m
+         WHERE m.rowid NOT IN (SELECT rowid FROM chunk_metadata) AND ${searchableVectorSql('chunks', 'm.rowid')} LIMIT ${RECON_BATCH}`).safeIntegers(true).all();
+            if (orphans.length === 0)
+                break;
+            batchTx(() => { for (const r of orphans) {
+                deleteVector(db, 'chunks', r.rowid);
+                touched++;
+            } });
+            if (orphans.length < RECON_BATCH)
+                break;
+            await new Promise(r => setImmediate(r));
+        }
         // 2. stamped entity metadata whose vector row is gone -> normalize to missing (was: delete). Keeping the
         //    row keeps its rowid, so the backfill re-inserts at the same rowid (r3 M2 case C: restart after repair).
         await batchedRun(`UPDATE entity_embedding_metadata SET input_hash = NULL, profile_id = NULL, provenance_state = NULL
@@ -178,8 +196,10 @@ export class BackfillCoordinator {
             });
             await new Promise(r => setImmediate(r));
         }
-        if (touched > 0)
-            console.error(`🧾 provenance sanitation: ${touched} split-state/old-profile rows invalidated`);
+        if (touched > 0) {
+            this.snapshot = null; // cached coverage (incl. orphan_vectors) is stale — also on the legacy=0 early return (2_ r1 R2)
+            console.error(`🧾 provenance sanitation: ${touched} split-state/old-profile/orphan rows invalidated`);
+        }
         return touched;
     }
     // Single-flight, idempotent. off mode defers (spec §9); fresh DBs go straight
@@ -612,6 +632,18 @@ export class BackfillCoordinator {
         const entQ = byState(`SELECT m.provenance_state s, COUNT(*) c FROM entity_embedding_metadata m
        WHERE ${searchableVectorSql('entity_embeddings', 'm.rowid')} GROUP BY m.provenance_state`);
         const entBy = entQ.rows;
+        const orphanQ = (t, meta) => {
+            try {
+                return db.prepare(`SELECT COUNT(*) c FROM ${t}_rowids m WHERE m.rowid NOT IN (SELECT rowid FROM ${meta}) AND ${searchableVectorSql(t, 'm.rowid')}`).get().c;
+            }
+            catch (e) {
+                if (!(e instanceof VecSlotError) && !String(e.message).includes('vec0 slot'))
+                    throw e;
+                return undefined;
+            }
+        };
+        const chunkOrphans = orphanQ('chunks', 'chunk_metadata');
+        const entOrphans = orphanQ('entity_embeddings', 'entity_embedding_metadata');
         const pick = (rows, s) => rows.find(r => r.s === s)?.c ?? 0;
         // Searchable = verified + legacy_assumed. NULL rows (pre-reconciliation or
         // deferred in off mode) are NOT counted as embedded (6R note 4).
@@ -620,9 +652,9 @@ export class BackfillCoordinator {
         const entVerified = pick(entBy, 'verified');
         const entLegacy = pick(entBy, 'legacy_assumed');
         this.snapshot = {
-            chunk: { total: chunkTotal, embedded: chunkVerified + chunkLegacy, verified: chunkVerified, legacy_assumed: chunkLegacy,
+            chunk: { total: chunkTotal, embedded: chunkVerified + chunkLegacy, verified: chunkVerified, legacy_assumed: chunkLegacy, orphan_vectors: chunkOrphans,
                 ...(chunkQ.error ? { error: chunkQ.error } : {}) },
-            entity: { total: entTotal, embedded: entVerified + entLegacy, verified: entVerified, legacy_assumed: entLegacy,
+            entity: { total: entTotal, embedded: entVerified + entLegacy, verified: entVerified, legacy_assumed: entLegacy, orphan_vectors: entOrphans,
                 ...(entQ.error ? { error: entQ.error } : {}) },
         };
         return this.snapshot;

package/dist/src/vecSimilarity.d.ts

@@ -0,0 +1,17 @@
+/**
+ * vec0 tables (chunks · entity_embeddings) are created without `distance_metric`, so sqlite-vec returns the
+ * default L2 distance. Embeddings are unit-normalized (`normalize: true`), so for unit vectors
+ * ‖a − b‖² = 2 − 2·cos  →  cosine similarity = 1 − d²/2.
+ * The earlier conversion 1 − d/2 treated the L2 value as a cosine distance: right − old = (d − d²)/2, so it
+ * under-reported for d < 1 (cos > 0.5: cos 0.8 showed ≈0.684) and over-reported for d > 1 (orthogonal showed
+ * ≈0.293 instead of 0 · cos 0.3 showed ≈0.408 and passed the 0.4 graph-seed threshold). Clamped to [0, 1].
+ * Guarded by test/vec-similarity.test.mjs (also asserts the metric is still L2).
+ */
+export declare function l2ToCosineSimilarity(distance: number): number;
+/**
+ * The 6.3.2 score, kept ONLY for the legacy paths that are pinned byte-for-byte (engine commit 4ac3155 · test
+ * graph-context-explain): hybridSearch with useGraph:true or summaries on, and the graph-seed `> 0.4` threshold of
+ * explainGraphContext. It is the historical 1 − d/2 conversion of an L2 distance and is NOT a cosine similarity
+ * (its 0.4 threshold equals a real cosine of about 0.28). Default search and searchNodes use l2ToCosineSimilarity.
+ */
+export declare function legacyL2AsCosineScore(distance: number): number;

package/dist/src/vecSimilarity.js

@@ -0,0 +1,23 @@
+/**
+ * vec0 tables (chunks · entity_embeddings) are created without `distance_metric`, so sqlite-vec returns the
+ * default L2 distance. Embeddings are unit-normalized (`normalize: true`), so for unit vectors
+ * ‖a − b‖² = 2 − 2·cos  →  cosine similarity = 1 − d²/2.
+ * The earlier conversion 1 − d/2 treated the L2 value as a cosine distance: right − old = (d − d²)/2, so it
+ * under-reported for d < 1 (cos > 0.5: cos 0.8 showed ≈0.684) and over-reported for d > 1 (orthogonal showed
+ * ≈0.293 instead of 0 · cos 0.3 showed ≈0.408 and passed the 0.4 graph-seed threshold). Clamped to [0, 1].
+ * Guarded by test/vec-similarity.test.mjs (also asserts the metric is still L2).
+ */
+export function l2ToCosineSimilarity(distance) {
+    if (!Number.isFinite(distance))
+        return 0;
+    return Math.min(1, Math.max(0, 1 - (distance * distance) / 2));
+}
+/**
+ * The 6.3.2 score, kept ONLY for the legacy paths that are pinned byte-for-byte (engine commit 4ac3155 · test
+ * graph-context-explain): hybridSearch with useGraph:true or summaries on, and the graph-seed `> 0.4` threshold of
+ * explainGraphContext. It is the historical 1 − d/2 conversion of an L2 distance and is NOT a cosine similarity
+ * (its 0.4 threshold equals a real cosine of about 0.28). Default search and searchNodes use l2ToCosineSimilarity.
+ */
+export function legacyL2AsCosineScore(distance) {
+    return Math.max(0, 1 - distance / 2);
+}

package/docs/UPDATING.md

@@ -108,6 +108,14 @@ path and holder pid (e.g. `.download-<key>.lock`). Verify the holder process
 is genuinely gone or hung (`ps -p <pid>`), then remove the lock file manually;
 the next start becomes a clean download owner.
 
+## v6.4.4 (schema v14, unchanged): real cosine similarity in default search, chunk orphan vectors cleaned
+
+**What changes for an existing database.** Nothing is migrated and nothing is re-embedded. On the first reconciliation
+after start, searchable chunk vectors that have no metadata row are deleted (the count shows as
+`coverage.chunk.orphan_vectors` before, 0 after). Similarity numbers shown by `searchNodes` and the default
+`hybridSearch` change to real cosine values; their order does not. `useGraph: true` and summaries-on results stay as in
+6.4.3. An engine that is already running keeps the old behaviour until it restarts on 6.4.4.
+
 ## v6.4.3 (schema v14, unchanged): vector slots rewritten in place, idle rebuild, searchable-only coverage
 
 **What changes for an existing database.** Nothing is migrated and nothing is re-embedded. Re-embeds stop leaving empty

package/package.json

@@ -1,6 +1,6 @@
 {
  "name": "rag-memory-epf-mcp",
- "version": "6.4.3",
+ "version": "6.4.4",
  "engines": {
   "node": ">=24"
  },
@@ -45,7 +45,7 @@
   "prepare": "npm run build",
   "watch": "tsc --watch",
   "verify:invariants": "node test/chunk-invariants.test.mjs",
-  "verify:engine": "node test/engine-smoke.test.mjs && node test/launch-smoke.test.mjs && node test/sync-atomicity.test.mjs && node test/dedup.test.mjs && node test/search-degradation.test.mjs && node test/entity-embed-cap.test.mjs && node test/migration12.test.mjs && node test/model-cache.test.mjs && node test/embedding-gate.test.mjs && node test/lazy-boot.test.mjs && node test/reconciliation.test.mjs && node test/backfill.test.mjs && node test/fts-query.test.mjs && node test/search-contracts.test.mjs && node test/tool-contracts.test.mjs && node test/bounded-exit.test.mjs && node test/observation-schema.test.mjs && node test/search-graph-default.test.mjs && node test/observation-migration.test.mjs && node test/observation-lifecycle.test.mjs && node test/observation-contracts.test.mjs && node test/observation-search.test.mjs && node test/observation-cascade.test.mjs && node test/observation-realdata.test.mjs && node --no-concurrent-sparkplug test/chunker-c.test.mjs && node test/migration14.test.mjs && node test/chunk-params-validation.test.mjs && node test/vector-reuse.test.mjs && node test/entity-range-linking.test.mjs && node test/alias-link-gate.test.mjs && node test/entity-name-boundary.test.mjs && node test/stats-chunking.test.mjs && node test/migration14-realdata.test.mjs && node test/migration14-realdata-sync.test.mjs && node test/search-summaries-off.test.mjs && node test/search-fusion-rrf.test.mjs && node test/query-input.test.mjs && node test/document-return-contracts.test.mjs && node test/observation-date-prefix.test.mjs && node test/delete-entities-cascade.test.mjs && node test/delete-entities-kg-hygiene.test.mjs && node test/backup-publish-portable.test.mjs && node test/graph-context-explain.test.mjs && node test/eval-graph-role-libs.test.mjs && node test/eval-graph-role-t5b.test.mjs && node --test test/eval-graph-role-t8-fix.test.mjs && node --test test/eval-graph-role-t7-upstream.test.mjs && node --test test/eval-graph-role-t11-decision.test.mjs && node --test test/eval-graph-role-prereq-fix.test.mjs && node test/db-path.test.mjs && node test/mmap-option.test.mjs && node test/wal-exit.test.mjs && node test/wal-sidecar-guard.test.mjs && node test/kg-evidence-core.test.mjs && node test/kg-delete-relation.test.mjs && node test/kg-confidence-copy.test.mjs && node test/kg-embed-cas.test.mjs && node test/kg-relation-evidence.test.mjs && node test/kg-detail-context.test.mjs && node test/kg-evidence-invalidation.test.mjs && node test/kg-evidence-cas.test.mjs && node test/kg-defaults.test.mjs && node test/chunker-oversize-cost.test.mjs && node test/chunker-structure-parity.test.mjs && node test/search-limit-depth.test.mjs && node test/kg-import-id-contract.test.mjs && node test/kg-evidence-guards.test.mjs && node test/model-session-options.test.mjs && node test/write-seq.test.mjs && node test/vec-slot-reuse.test.mjs && node test/vec-rebuild.test.mjs && node test/vec-slot-invalid.test.mjs",
+  "verify:engine": "node test/engine-smoke.test.mjs && node test/launch-smoke.test.mjs && node test/sync-atomicity.test.mjs && node test/dedup.test.mjs && node test/search-degradation.test.mjs && node test/entity-embed-cap.test.mjs && node test/migration12.test.mjs && node test/model-cache.test.mjs && node test/embedding-gate.test.mjs && node test/lazy-boot.test.mjs && node test/reconciliation.test.mjs && node test/backfill.test.mjs && node test/fts-query.test.mjs && node test/search-contracts.test.mjs && node test/tool-contracts.test.mjs && node test/bounded-exit.test.mjs && node test/observation-schema.test.mjs && node test/search-graph-default.test.mjs && node test/observation-migration.test.mjs && node test/observation-lifecycle.test.mjs && node test/observation-contracts.test.mjs && node test/observation-search.test.mjs && node test/observation-cascade.test.mjs && node test/observation-realdata.test.mjs && node --no-concurrent-sparkplug test/chunker-c.test.mjs && node test/migration14.test.mjs && node test/chunk-params-validation.test.mjs && node test/vector-reuse.test.mjs && node test/entity-range-linking.test.mjs && node test/alias-link-gate.test.mjs && node test/entity-name-boundary.test.mjs && node test/stats-chunking.test.mjs && node test/migration14-realdata.test.mjs && node test/migration14-realdata-sync.test.mjs && node test/search-summaries-off.test.mjs && node test/search-fusion-rrf.test.mjs && node test/query-input.test.mjs && node test/document-return-contracts.test.mjs && node test/observation-date-prefix.test.mjs && node test/delete-entities-cascade.test.mjs && node test/delete-entities-kg-hygiene.test.mjs && node test/backup-publish-portable.test.mjs && node test/graph-context-explain.test.mjs && node test/eval-graph-role-libs.test.mjs && node test/eval-graph-role-t5b.test.mjs && node --test test/eval-graph-role-t8-fix.test.mjs && node --test test/eval-graph-role-t7-upstream.test.mjs && node --test test/eval-graph-role-t11-decision.test.mjs && node --test test/eval-graph-role-prereq-fix.test.mjs && node test/db-path.test.mjs && node test/mmap-option.test.mjs && node test/wal-exit.test.mjs && node test/wal-sidecar-guard.test.mjs && node test/kg-evidence-core.test.mjs && node test/kg-delete-relation.test.mjs && node test/kg-confidence-copy.test.mjs && node test/kg-embed-cas.test.mjs && node test/kg-relation-evidence.test.mjs && node test/kg-detail-context.test.mjs && node test/kg-evidence-invalidation.test.mjs && node test/kg-evidence-cas.test.mjs && node test/kg-defaults.test.mjs && node test/chunker-oversize-cost.test.mjs && node test/chunker-structure-parity.test.mjs && node test/search-limit-depth.test.mjs && node test/kg-import-id-contract.test.mjs && node test/kg-evidence-guards.test.mjs && node test/model-session-options.test.mjs && node test/write-seq.test.mjs && node test/vec-slot-reuse.test.mjs && node test/vec-rebuild.test.mjs && node test/vec-slot-invalid.test.mjs && node test/vec-similarity.test.mjs && node test/chunk-orphan-vectors.test.mjs",
   "test": "npm run build && npm run verify:invariants && npm run verify:engine",
   "prepublishOnly": "npm run build && npm run verify:invariants && npm run verify:engine"
  },