@dzhechkov/harness-core 0.8.33 → 0.8.34

package/sbom.json

@@ -25,7 +25,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "70cf5d858ca889a834345fe7c00f7312fc65477f5e5c3f6d2f4dd7d742ca2ed3"
+          "content": "7fb2af101753ac28e469a24a8f15789d0235d5749dd3a3cda42422d61ff13c0d"
         }
       ]
     },
@@ -75,7 +75,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "69023233508c656035c8a27b95690bcfddab535d25dffb85f2041c4bfbf77f64"
+          "content": "6e86eca1e1b3db58f83c5e60b3af2943cb97a7365eb9754825b3e2fcdde5fe22"
         }
       ]
     },
@@ -85,7 +85,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "965f21e2cb4c4f6ac8cf51b0238a64c3c44b0442ecc2ec198d67463bd7e76b31"
+          "content": "601500870a060848fd75912b8473b1d715ab4c97ea1d8c91db0711e0a0ebf352"
         }
       ]
     },
@@ -95,7 +95,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "2975c8ee201c4b6e7d78d0a7fc34e976d2d1c97692e6fce82c56417d90d397cd"
+          "content": "fdb88618197b66d9b107c50ac75b625e23a4498ddb20d13d8e9168d7e6aee790"
         }
       ]
     },
@@ -105,7 +105,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "866790c8dcb6614538513927c389231e3617ec5c883470e1e15c19d1f3b2128b"
+          "content": "8ada5fd59f070ece1436c97b0d4e96bc9067a2ab042a06637a4592ee9fcf74e9"
         }
       ]
     },
@@ -315,7 +315,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "a3b35c162ce1059ec52e66250f4d5eb40ea80031bc6ba211cf2c239125da2dab"
+          "content": "7d405581035820ac6e35fc3acf30685fb66f97120f4222d4389e81182cb234b6"
         }
       ]
     },
@@ -325,7 +325,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "a16afc919647db2ea568e29bf0e835df023a025716bf73e60ab5294300fee486"
+          "content": "1ec81dba7e182385ee9cebd1d4c41128915549797fb07bbff0cc540b7f72287a"
         }
       ]
     },
@@ -335,7 +335,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "604ff5b789bf969728c174c560a0b463d64307f0120699feb28ed839d0e42afa"
+          "content": "94a7c64d577a8134413cd508b37ec346cf729571b86b0d0cb55168d9a67f7a76"
         }
       ]
     },
@@ -345,7 +345,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "78b6f40ca672f6ea40ce4d29c9ae9baab74c74252400a5e05540272a612201b1"
+          "content": "cc1ed9820f186de277c75bbcffd102e651e34283a7728307d4c377ad7e207b7a"
         }
       ]
     },
@@ -2595,7 +2595,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "9268dcea6b76bcc172de258f26b263384be72751ecd80bf695d30fa956ce3255"
+          "content": "0ec8aabd62c19b421d56b9ddfc3a769ca88a6edad072e6b458a9ec0dce144847"
         }
       ]
     },
@@ -2605,7 +2605,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "525593dc52d74876f41071fc906828b3b1807d5b8d1bf0e570589b8f5e23a6cd"
+          "content": "d55811cc24161673964196697f78774b618ceff986f12d61233129af1309a06e"
         }
       ]
     },
@@ -2615,7 +2615,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "645544ee8ebb51df85c94f1150134c76885678ac0c54dfaaacfaa38090549ee6"
+          "content": "db5d3897a75a8b5f41e4d63fc2b89e1ba0ad59d81c9ec7409f4a4e4bcaef3ed2"
         }
       ]
     },
@@ -2625,7 +2625,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "0a45a791953cdecc4fb0bff3d39ea158f1d204ba5c3507783affd94fc38c559a"
+          "content": "7ed1c3d692bf9f60b3239b2ec714552c524139f98a666529c1c614c00b1928a2"
         }
       ]
     },
@@ -3725,7 +3725,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "f147b33e2edd6766f4d8256f980315a1458f0408bb0683f5324ccee28e0b8223"
+          "content": "5e21fd824b54842ab455e1c2b4d381d3ba81eaefb37ee525ab44b61f3e1a4719"
         }
       ]
     },
@@ -3735,7 +3735,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "568d5ea2e70f3672deadf656384e0dedc8f02136e1aacfbff18b523ee0c90fa9"
+          "content": "cb895bd26042f722c29594f1c5d0db6471146516745de6b366ed3b1a06af1906"
         }
       ]
     },
@@ -3745,7 +3745,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "43e8044e64abc740d5db2486e149acdc943c58a046d9b0c94038e53c207fc0af"
+          "content": "3d7103bd1f9c96aefe9ade44d53a321ae5c057171a6556b228350fc3faf74f33"
         }
       ]
     },
@@ -4195,7 +4195,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "63e4bb439f1366114d21b9796489fec34308c34818bddeb6b69f590b8882c0fd"
+          "content": "8e39c9f1d527ddaaa8b8655ee1e2fa0ee005926e25da8c3218cf0fb9cbed5502"
         }
       ]
     },
@@ -4205,7 +4205,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "6c564150ddcb07ce2994c63764a0acb3d282bd702ed79dc906c886affc3e84e9"
+          "content": "257237bac3a1d173113b4525ea19dbb4f7984a08ad017ebdd7af164ba6cc7cfe"
         }
       ]
     },
@@ -4215,7 +4215,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "b99fca72e63868d9177052aefe47390e9f5e08ff6869d65299dc0286c8bdfd18"
+          "content": "16ac3f704998f295ed42c112277482d6adfb5d26e4c8a4c89781d24b63118f6f"
         }
       ]
     },
@@ -4225,7 +4225,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "504ecc5393016745aef5c60dfa9162a6531625a56b34ced46f4f8ee31d72bf11"
+          "content": "8143d41cd1c706713fe6d9a742b71d9a28b3519a72072ca4683837ab54732d30"
         }
       ]
     },
@@ -4755,7 +4755,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "cf5750b9c6d474c45cfd81b7cbb2f92a18b452fa1c069e4e3fbfc4dac06267d9"
+          "content": "937161c359ffed77233d43ba2b5280cd8f34962baa1758daf8479805e23621ef"
         }
       ]
     },
@@ -4765,7 +4765,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "6eaca079115921991149d68189ed8ef8c61be6efd12c426df8d091c1b39da5b9"
+          "content": "6ce025a95be2b36246e6a8dbe3b324539e60d3f79febe1330071e51fced1282a"
         }
       ]
     },
@@ -4775,7 +4775,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "627e5efa90298701d01bee346790647f5688dc0f10c4727b348298490c35d219"
+          "content": "0030839d3dfaa43dabed352703255a7f6f0e11c8e3db01abaa4341fddb57e211"
         }
       ]
     },
@@ -4785,7 +4785,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "a539f499cf28923856c6cb6f40417d67d662c6771b4df8fe4e7fe5ab9f2a7121"
+          "content": "2f1cfa37c4f868859e6ea2b5aba4b896bd106e8ed1a9a8b5285b9ad30e52d896"
         }
       ]
     },
@@ -6635,7 +6635,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "289cc4a73d023af16d44ab00caa4c1cad2cbe6bd6720b6eddf932ef37e200a5b"
+          "content": "cdf68fa28b6a7e78d0381a5b2d23647ae812fee004e31b4c8c3893a897fd6f6f"
         }
       ]
     },
@@ -6645,7 +6645,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "52e4813a1af157a58ea91b7787c44c09dfc68e44b0baee315182467913c4dc08"
+          "content": "2943b848f7af427dcfecf801a778fe7eb2a6f899e395956aca5f45a9fcce3d79"
         }
       ]
     },
@@ -6655,7 +6655,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "cf0d978a1e9bffb32a854d20a0a88a4daad7e852f12287db15ae1707c0db66a3"
+          "content": "a48e13d799185bc95134a23cbe7d9ee91f9dcaf64c1c7c5faa4cf45a4cf94d08"
         }
       ]
     },
@@ -6665,7 +6665,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "f8db2ecd2284f2d5af15049443aa295c56fa3d67a2240bb4f08b884f36cf41bd"
+          "content": "9a74e49879f494f01aec757b4efe0f41245cf20cf1cc4e07123852f6939463cf"
         }
       ]
     },
@@ -6839,7 +6839,7 @@
         },
         {
           "name": "dz:canonical-json-sha256-v2",
-          "value": "a6f86350222413a151c6d4f73d9c80f4e2d3c21297000e2fe7b0708248d77724"
+          "value": "26a1b1c5cd3d01ea854d9fb9ef126fe3cfd6580a52d0a1c7b60f4dffcc280d8d"
         }
       ]
     },
@@ -6859,7 +6859,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "49c55278320cf79d50463374cb4bd98702381eefc61aa81cf3889f117857f7d0"
+          "content": "f3b7a86fc7ec49fc7b47d69a6beb4ace4e193f9a4b63237b257a7cae1879d4f7"
         }
       ]
     },
@@ -6919,7 +6919,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "15feafe9dedd298f2d8f7815d2a100cedaf4864223affb80f8e8c34317e4b0f6"
+          "content": "d0bc07ff16397b8d0d6b26fd72a770553f421902b81e3d5e775e08b4db4710a3"
         }
       ]
     },
@@ -7499,7 +7499,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "307f2d574fd2d7a0f2b8ebe7a36047f0c3d8cade6e8fdda9e10e26d344914912"
+          "content": "a2ae53ebaa9993545153419f615db85f7a2d412f61deddb44780773e8ea52be2"
         }
       ]
     },
@@ -7789,7 +7789,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "fd66a40569fd53cbf0d621643ace1e4f89777e9634bcda24a730e971dc240ccd"
+          "content": "9f20a5a9c3e6ff41245612f74f04f62e719744fab2f97ee9d93fcdf4fa52668b"
         }
       ]
     },
@@ -7909,7 +7909,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "2bd607ec044e2bca2a7336e10d69cee99db53e6f41b60bfa770711d756dd9116"
+          "content": "5a7c2cffce4e62e4e859578b7014020670125e1ea68d4e04f2b1f6256c423b7a"
         }
       ]
     },
@@ -8049,7 +8049,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "b7e248afaadc503642ef3b22eb86817e8ecb12744493c1780065de87772483a4"
+          "content": "4e3390606a39f54b2a15db985a6e72a4f34c2ef59765c5124e1d64844d97447c"
         }
       ]
     },
@@ -8519,7 +8519,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "f5b5187d2537f2d00c3f248676928d286e715e9984f67491aa1e02eb0f4b1b50"
+          "content": "6086c8aabf98d69d9fc7d8b22d88dfbe1588ac1a4e2ddae66a3738e02dc638f2"
         }
       ]
     },

package/src/agentdb-index.ts

@@ -284,30 +284,43 @@ export interface AgentdbSearchResult {
 
 const DEPS_MISSING = 'agentdb/better-sqlite3 not installed in project (run: dz setup --memory agentdb)';
 
+type Embedder = { embed: (t: string) => Promise<Float32Array> } | { error: string };
+
 /**
- * Resolve agentdb's `EmbeddingService` from the PROJECT (same dynamic-resolution discipline as
- * {@link indexPatternsToAgentdb}); every dz call site uses the same resolved model so query and row
- * vectors stay in the same space.
+ * `agentdb-embedder-cache` (feature): the transformers pipeline behind `EmbeddingService` is
+ * expensive to stand up (MEASURED 2026-09-14: 2-3.6s per `resolveAgentdbEmbedder` call — see
+ * `features/agentdb-embedder-cache/00_complexity_assessment.md`), yet the resolved model/dim never
+ * changes within one process. Keyed by `${agentdbDir}|${model}|${dim}` so a config/env change (a
+ * different `resolveEmbedModel` source) gets its own entry (FR-2) rather than reusing a stale
+ * pipeline. The PROMISE is cached, not the awaited result (FR-4): concurrent first callers for the
+ * same key join the same in-flight initialization instead of racing two pipelines. An `{error}`
+ * outcome (or a rejection) evicts its own entry so the next call retries cleanly (FR-3) — a failure
+ * must never "stick".
  */
-export async function resolveAgentdbEmbedder(
-  projectRoot: string,
-): Promise<{ embed: (t: string) => Promise<Float32Array> } | { error: string }> {
-  let agentdbDir: string;
-  try {
-    const req = createRequire(join(projectRoot, 'package.json'));
-    agentdbDir = dirname(req.resolve('agentdb'));
-  } catch {
-    return { error: DEPS_MISSING };
-  }
+const embedderCache = new Map<string, Promise<Embedder>>();
+let embedderCacheInitializations = 0;
+
+/** Test-only (and future warm-start) reset — callers (`vector-tier.ts`, `backlog.ts`) are unaffected. */
+export function resetAgentdbEmbedderCache(): void {
+  embedderCache.clear();
+  embedderCacheInitializations = 0;
+}
+
+/** `entries` = cached keys right now — a SUCCESSFUL pipeline or an IN-FLIGHT initialization (the promise is
+ * cached before it settles, FR-4; a failed one is evicted, FR-3); `initializations` = pipelines actually
+ * started since the last reset. (Codex round-1, 2026-09-14: the earlier wording said "successful" only.) */
+export function getAgentdbEmbedderCacheStats(): { entries: number; initializations: number } {
+  return { entries: embedderCache.size, initializations: embedderCacheInitializations };
+}
+
+async function initAgentdbEmbedder(agentdbDir: string, model: string, dim: number): Promise<Embedder> {
   try {
     const { EmbeddingService } = (await import(pathToFileURL(join(agentdbDir, 'controllers', 'EmbeddingService.js')).href)) as {
       EmbeddingService: new (o: object) => { initialize: () => Promise<void>; embed: (t: string) => Promise<Float32Array> };
     };
-    const model = resolveEmbedModel(projectRoot);
-    if ('error' in model) return { error: model.error };
     const emb = new EmbeddingService({
-      model: model.model,
-      dimension: model.dim,
+      model,
+      dimension: dim,
       provider: 'transformers',
       // agentdb >= 3.0.0-alpha.20 refuses UNREGISTERED models without an explicit role policy
       // (its built-in registry knows all-MiniLM-L6-v2 but not our multilingual variant — grounded
@@ -325,6 +338,41 @@ export async function resolveAgentdbEmbedder(
   }
 }
 
+/**
+ * Resolve agentdb's `EmbeddingService` from the PROJECT (same dynamic-resolution discipline as
+ * {@link indexPatternsToAgentdb}); every dz call site uses the same resolved model so query and row
+ * vectors stay in the same space. Cached per process — see {@link embedderCache} above.
+ */
+export async function resolveAgentdbEmbedder(projectRoot: string): Promise<Embedder> {
+  let agentdbDir: string;
+  try {
+    const req = createRequire(join(projectRoot, 'package.json'));
+    agentdbDir = dirname(req.resolve('agentdb'));
+  } catch {
+    return { error: DEPS_MISSING };
+  }
+  const model = resolveEmbedModel(projectRoot);
+  if ('error' in model) return { error: model.error };
+  const key = `${agentdbDir}|${model.model}|${model.dim}`;
+  const hit = embedderCache.get(key);
+  if (hit !== undefined) return hit;
+  embedderCacheInitializations += 1;
+  const promise = initAgentdbEmbedder(agentdbDir, model.model, model.dim);
+  embedderCache.set(key, promise);
+  // FR-3: an init failure must not stick — evict so the next call retries instead of replaying
+  // the same {error} forever. `.catch` here only guards a rejection that slips past
+  // `initAgentdbEmbedder`'s own try/catch; it never rethrows (this is bookkeeping, not the return path).
+  void promise.then(
+    (result) => {
+      if ('error' in result && embedderCache.get(key) === promise) embedderCache.delete(key);
+    },
+    () => {
+      if (embedderCache.get(key) === promise) embedderCache.delete(key);
+    },
+  );
+  return promise;
+}
+
 /** `absent: true` = no store file yet — an EMPTY mirror is a state, not an error (backfill relies on this). */
 function openReadonly(projectRoot: string, dbPath?: string): { db: ReadonlyDb } | { absent: true } | { error: string } {
   const dbFile = resolveAgentdbPath(projectRoot, dbPath);