@dzhechkov/harness-core 0.8.33 → 0.8.34

package/.dz-manifest.json

@@ -9,7 +9,7 @@
       },
       {
         "path": "README.md",
-        "sha256": "70cf5d858ca889a834345fe7c00f7312fc65477f5e5c3f6d2f4dd7d742ca2ed3"
+        "sha256": "7fb2af101753ac28e469a24a8f15789d0235d5749dd3a3cda42422d61ff13c0d"
       },
       {
         "path": "dist/__tests__/golden-baseline.test.d.ts",
@@ -29,19 +29,19 @@
       },
       {
         "path": "dist/agentdb-index.d.ts",
-        "sha256": "69023233508c656035c8a27b95690bcfddab535d25dffb85f2041c4bfbf77f64"
+        "sha256": "6e86eca1e1b3db58f83c5e60b3af2943cb97a7365eb9754825b3e2fcdde5fe22"
       },
       {
         "path": "dist/agentdb-index.d.ts.map",
-        "sha256": "965f21e2cb4c4f6ac8cf51b0238a64c3c44b0442ecc2ec198d67463bd7e76b31"
+        "sha256": "601500870a060848fd75912b8473b1d715ab4c97ea1d8c91db0711e0a0ebf352"
       },
       {
         "path": "dist/agentdb-index.js",
-        "sha256": "2975c8ee201c4b6e7d78d0a7fc34e976d2d1c97692e6fce82c56417d90d397cd"
+        "sha256": "fdb88618197b66d9b107c50ac75b625e23a4498ddb20d13d8e9168d7e6aee790"
       },
       {
         "path": "dist/agentdb-index.js.map",
-        "sha256": "866790c8dcb6614538513927c389231e3617ec5c883470e1e15c19d1f3b2128b"
+        "sha256": "8ada5fd59f070ece1436c97b0d4e96bc9067a2ab042a06637a4592ee9fcf74e9"
       },
       {
         "path": "dist/agentdb-reindex-marker.d.ts",
@@ -125,19 +125,19 @@
       },
       {
         "path": "dist/apply-leg.d.ts",
-        "sha256": "a3b35c162ce1059ec52e66250f4d5eb40ea80031bc6ba211cf2c239125da2dab"
+        "sha256": "7d405581035820ac6e35fc3acf30685fb66f97120f4222d4389e81182cb234b6"
       },
       {
         "path": "dist/apply-leg.d.ts.map",
-        "sha256": "a16afc919647db2ea568e29bf0e835df023a025716bf73e60ab5294300fee486"
+        "sha256": "1ec81dba7e182385ee9cebd1d4c41128915549797fb07bbff0cc540b7f72287a"
       },
       {
         "path": "dist/apply-leg.js",
-        "sha256": "604ff5b789bf969728c174c560a0b463d64307f0120699feb28ed839d0e42afa"
+        "sha256": "94a7c64d577a8134413cd508b37ec346cf729571b86b0d0cb55168d9a67f7a76"
       },
       {
         "path": "dist/apply-leg.js.map",
-        "sha256": "78b6f40ca672f6ea40ce4d29c9ae9baab74c74252400a5e05540272a612201b1"
+        "sha256": "cc1ed9820f186de277c75bbcffd102e651e34283a7728307d4c377ad7e207b7a"
       },
       {
         "path": "dist/apply.d.ts",
@@ -1037,19 +1037,19 @@
       },
       {
         "path": "dist/index.d.ts",
-        "sha256": "9268dcea6b76bcc172de258f26b263384be72751ecd80bf695d30fa956ce3255"
+        "sha256": "0ec8aabd62c19b421d56b9ddfc3a769ca88a6edad072e6b458a9ec0dce144847"
       },
       {
         "path": "dist/index.d.ts.map",
-        "sha256": "525593dc52d74876f41071fc906828b3b1807d5b8d1bf0e570589b8f5e23a6cd"
+        "sha256": "d55811cc24161673964196697f78774b618ceff986f12d61233129af1309a06e"
       },
       {
         "path": "dist/index.js",
-        "sha256": "645544ee8ebb51df85c94f1150134c76885678ac0c54dfaaacfaa38090549ee6"
+        "sha256": "db5d3897a75a8b5f41e4d63fc2b89e1ba0ad59d81c9ec7409f4a4e4bcaef3ed2"
       },
       {
         "path": "dist/index.js.map",
-        "sha256": "0a45a791953cdecc4fb0bff3d39ea158f1d204ba5c3507783affd94fc38c559a"
+        "sha256": "7ed1c3d692bf9f60b3239b2ec714552c524139f98a666529c1c614c00b1928a2"
       },
       {
         "path": "dist/integration-apply.d.ts",
@@ -1489,15 +1489,15 @@
       },
       {
         "path": "dist/operations.d.ts.map",
-        "sha256": "f147b33e2edd6766f4d8256f980315a1458f0408bb0683f5324ccee28e0b8223"
+        "sha256": "5e21fd824b54842ab455e1c2b4d381d3ba81eaefb37ee525ab44b61f3e1a4719"
       },
       {
         "path": "dist/operations.js",
-        "sha256": "568d5ea2e70f3672deadf656384e0dedc8f02136e1aacfbff18b523ee0c90fa9"
+        "sha256": "cb895bd26042f722c29594f1c5d0db6471146516745de6b366ed3b1a06af1906"
       },
       {
         "path": "dist/operations.js.map",
-        "sha256": "43e8044e64abc740d5db2486e149acdc943c58a046d9b0c94038e53c207fc0af"
+        "sha256": "3d7103bd1f9c96aefe9ade44d53a321ae5c057171a6556b228350fc3faf74f33"
       },
       {
         "path": "dist/package-skill-layouts.d.ts",
@@ -1677,19 +1677,19 @@
       },
       {
         "path": "dist/publish-sibling-drift.d.ts",
-        "sha256": "63e4bb439f1366114d21b9796489fec34308c34818bddeb6b69f590b8882c0fd"
+        "sha256": "8e39c9f1d527ddaaa8b8655ee1e2fa0ee005926e25da8c3218cf0fb9cbed5502"
       },
       {
         "path": "dist/publish-sibling-drift.d.ts.map",
-        "sha256": "6c564150ddcb07ce2994c63764a0acb3d282bd702ed79dc906c886affc3e84e9"
+        "sha256": "257237bac3a1d173113b4525ea19dbb4f7984a08ad017ebdd7af164ba6cc7cfe"
       },
       {
         "path": "dist/publish-sibling-drift.js",
-        "sha256": "b99fca72e63868d9177052aefe47390e9f5e08ff6869d65299dc0286c8bdfd18"
+        "sha256": "16ac3f704998f295ed42c112277482d6adfb5d26e4c8a4c89781d24b63118f6f"
       },
       {
         "path": "dist/publish-sibling-drift.js.map",
-        "sha256": "504ecc5393016745aef5c60dfa9162a6531625a56b34ced46f4f8ee31d72bf11"
+        "sha256": "8143d41cd1c706713fe6d9a742b71d9a28b3519a72072ca4683837ab54732d30"
       },
       {
         "path": "dist/publish-signing.d.ts",
@@ -1901,19 +1901,19 @@
       },
       {
         "path": "dist/release.d.ts",
-        "sha256": "cf5750b9c6d474c45cfd81b7cbb2f92a18b452fa1c069e4e3fbfc4dac06267d9"
+        "sha256": "937161c359ffed77233d43ba2b5280cd8f34962baa1758daf8479805e23621ef"
       },
       {
         "path": "dist/release.d.ts.map",
-        "sha256": "6eaca079115921991149d68189ed8ef8c61be6efd12c426df8d091c1b39da5b9"
+        "sha256": "6ce025a95be2b36246e6a8dbe3b324539e60d3f79febe1330071e51fced1282a"
       },
       {
         "path": "dist/release.js",
-        "sha256": "627e5efa90298701d01bee346790647f5688dc0f10c4727b348298490c35d219"
+        "sha256": "0030839d3dfaa43dabed352703255a7f6f0e11c8e3db01abaa4341fddb57e211"
       },
       {
         "path": "dist/release.js.map",
-        "sha256": "a539f499cf28923856c6cb6f40417d67d662c6771b4df8fe4e7fe5ab9f2a7121"
+        "sha256": "2f1cfa37c4f868859e6ea2b5aba4b896bd106e8ed1a9a8b5285b9ad30e52d896"
       },
       {
         "path": "dist/repo-boundary.d.ts",
@@ -2653,19 +2653,19 @@
       },
       {
         "path": "dist/vector-tier.d.ts",
-        "sha256": "289cc4a73d023af16d44ab00caa4c1cad2cbe6bd6720b6eddf932ef37e200a5b"
+        "sha256": "cdf68fa28b6a7e78d0381a5b2d23647ae812fee004e31b4c8c3893a897fd6f6f"
       },
       {
         "path": "dist/vector-tier.d.ts.map",
-        "sha256": "52e4813a1af157a58ea91b7787c44c09dfc68e44b0baee315182467913c4dc08"
+        "sha256": "2943b848f7af427dcfecf801a778fe7eb2a6f899e395956aca5f45a9fcce3d79"
       },
       {
         "path": "dist/vector-tier.js",
-        "sha256": "cf0d978a1e9bffb32a854d20a0a88a4daad7e852f12287db15ae1707c0db66a3"
+        "sha256": "a48e13d799185bc95134a23cbe7d9ee91f9dcaf64c1c7c5faa4cf45a4cf94d08"
       },
       {
         "path": "dist/vector-tier.js.map",
-        "sha256": "f8db2ecd2284f2d5af15049443aa295c56fa3d67a2240bb4f08b884f36cf41bd"
+        "sha256": "9a74e49879f494f01aec757b4efe0f41245cf20cf1cc4e07123852f6939463cf"
       },
       {
         "path": "dist/workflow-run-dispatch.d.ts",
@@ -2733,7 +2733,7 @@
       },
       {
         "path": "package.json",
-        "sha256": "a6f86350222413a151c6d4f73d9c80f4e2d3c21297000e2fe7b0708248d77724"
+        "sha256": "26a1b1c5cd3d01ea854d9fb9ef126fe3cfd6580a52d0a1c7b60f4dffcc280d8d"
       },
       {
         "path": "src/__tests__/golden-baseline.test.ts",
@@ -2741,7 +2741,7 @@
       },
       {
         "path": "src/agentdb-index.ts",
-        "sha256": "49c55278320cf79d50463374cb4bd98702381eefc61aa81cf3889f117857f7d0"
+        "sha256": "f3b7a86fc7ec49fc7b47d69a6beb4ace4e193f9a4b63237b257a7cae1879d4f7"
       },
       {
         "path": "src/agentdb-reindex-marker.ts",
@@ -2765,7 +2765,7 @@
       },
       {
         "path": "src/apply-leg.ts",
-        "sha256": "15feafe9dedd298f2d8f7815d2a100cedaf4864223affb80f8e8c34317e4b0f6"
+        "sha256": "d0bc07ff16397b8d0d6b26fd72a770553f421902b81e3d5e775e08b4db4710a3"
       },
       {
         "path": "src/apply.ts",
@@ -2997,7 +2997,7 @@
       },
       {
         "path": "src/index.ts",
-        "sha256": "307f2d574fd2d7a0f2b8ebe7a36047f0c3d8cade6e8fdda9e10e26d344914912"
+        "sha256": "a2ae53ebaa9993545153419f615db85f7a2d412f61deddb44780773e8ea52be2"
       },
       {
         "path": "src/integration-apply.ts",
@@ -3113,7 +3113,7 @@
       },
       {
         "path": "src/operations.ts",
-        "sha256": "fd66a40569fd53cbf0d621643ace1e4f89777e9634bcda24a730e971dc240ccd"
+        "sha256": "9f20a5a9c3e6ff41245612f74f04f62e719744fab2f97ee9d93fcdf4fa52668b"
       },
       {
         "path": "src/package-skill-layouts.ts",
@@ -3161,7 +3161,7 @@
       },
       {
         "path": "src/publish-sibling-drift.ts",
-        "sha256": "2bd607ec044e2bca2a7336e10d69cee99db53e6f41b60bfa770711d756dd9116"
+        "sha256": "5a7c2cffce4e62e4e859578b7014020670125e1ea68d4e04f2b1f6256c423b7a"
       },
       {
         "path": "src/publish-signing.ts",
@@ -3217,7 +3217,7 @@
       },
       {
         "path": "src/release.ts",
-        "sha256": "b7e248afaadc503642ef3b22eb86817e8ecb12744493c1780065de87772483a4"
+        "sha256": "4e3390606a39f54b2a15db985a6e72a4f34c2ef59765c5124e1d64844d97447c"
       },
       {
         "path": "src/repo-boundary.ts",
@@ -3405,7 +3405,7 @@
       },
       {
         "path": "src/vector-tier.ts",
-        "sha256": "f5b5187d2537f2d00c3f248676928d286e715e9984f67491aa1e02eb0f4b1b50"
+        "sha256": "6086c8aabf98d69d9fc7d8b22d88dfbe1588ac1a4e2ddae66a3738e02dc638f2"
       },
       {
         "path": "src/workflow-run-dispatch.ts",
@@ -3425,5 +3425,5 @@
       }
     ]
   },
-  "signature": "9lkZG7XpDHs9qtNmKiBJYt3PMKTOAhxXxEU3F4n2uOYQps/u6lY0vb50bdKsxMoZem8/R2qORHxYCU4kN+iYAQ=="
+  "signature": "Qg/pWuzvk2SqP54zlyFPEq6VyAkl6aYu6bQuRgX8C4i/ePjQXMlMQn68zZDP1Fc9jj+vQbf7JJmEw/UjUreXAw=="
 }

package/README.md

@@ -604,6 +604,62 @@ instead of only ever checking the plain project path. The daemon also now prints
 (path N bytes)` and exits non-zero, never a silent "ready" for a socket that was never created
 (`APPLY_LEG_VERSION` bumped 3→4 for this and the resolver change).
 
+### One recall engine for hook and CLI (`hook-recall-hybrid-parity`, ADR-001, `APPLY_LEG_VERSION` 4→5)
+
+The daemon's `op: recall` handler used to run its own brute-force cosine loop over the in-memory
+mirror — a SECOND engine, diverging from `dz recall`'s `recallHybrid` (FTS5 lexical + semantic +
+RRF). MEASURED (record 097ca040): 41.8% of taught lessons went unretrieved by either path over 48
+days, and an exact lexical match at cosine 0.39 was silently dropped by the hook's cosine floor.
+
+`embedDaemonSource(coreDistDir?)` now takes the SAME `coreDistDir` parameter `recallHookSource`
+already had (default `null`, the hub's own portable marker) and inlines the SAME `loadCoreModule`
+candidate-list pattern the hook uses, loading `index.js` from the resolved `CORE_DIST_DIR` to reach
+`recallHybrid`/`patternRecordId`. `answerRecall(prompt, limit)` — the whole `op: recall` answer —
+tries `hybridRecall` first: `core.recallHybrid(PROJECT, prompt, { limit, mode: 'hook',
+deferExposures: true })`, raced via `Promise.race` against a `HOOK_RECALL_BUDGET_MS` timer (env,
+default 500, always below the hook's own 800 ms socket timeout). On success the reply carries
+`engine: 'hybrid'` and `hits[].score` normalized from the raw RRF sum into `[0,1]`
+(`score / (2/(RRF_K+1))`, `RRF_K=60` — duplicated from `vector-tier.ts`'s own constant since this is
+standalone generated text; `apply-leg-twins.test.ts` does not currently pin the two numerically
+equal, only that both exist as literals — a numeric drift would need to be caught by the parity
+test's own live assertions). On budget overrun / engine error / no resolvable core module, it falls
+straight through to TODAY'S cosine leg (byte-identical) with `engine: 'cosine-fallback'` and a
+`reason`.
+
+`HybridRecallMode` in `vector-tier.ts` gained a fourth literal, `'hook'` — ranked identically to
+`'hybrid'` (no semantic-weight change); its only role is to travel end to end for observability. The
+ACTUAL mechanism that keeps a per-prompt recall from moving the lesson-bandit's exposure counters is
+`deferExposures: true` plus never calling the returned `commitExposures(...)` — `recallHybrid`
+already supported deferral for `dz recall --domain`'s own over-fetch-and-truncate case; the daemon is
+simply a second caller of the same contract.
+
+`pickEngine` (the one seam `recallHybrid`, `mirrorPatternsToVector`, `teachGuard` etc. all resolve
+their engine through) now routes through `getOrOpenEngine(projectRoot)` instead of calling
+`resolveVectorEngine` directly — a per-process cache keyed by `(projectRoot, mtime of
+.dz/agentdb.db)`, so a long-lived caller (the daemon) pays the `isPackageInstalled`/`probeNativeDep`
+walk once, not once per prompt. A short-lived CLI invocation is unaffected (the cache is populated
+and discarded within one process either way — I-1 parity holds). `getOrOpenEngine`'s second
+parameter is an injectable resolver (default `resolveVectorEngine`) purely for spy-testability — two
+functions in the same ES module cannot be reliably intercepted by `vi.spyOn` when one calls the other
+by its local name.
+
+`dz doctor`'s "apply-leg alive (embed daemon)" check now sends one live `op: recall` probe
+(`probeRecallEngine`, `operations.ts`, 1000 ms default — comfortably above the 500 ms production
+budget default) when the socket exists, and appends `(engine: hybrid)` / `(engine: cosine-fallback)`
+to the detail line on a successful reply. A non-listening path (every non-live doctor fixture in this
+repo writes a plain file, never a real socket) fails the probe near-instantly, so every pre-existing
+detail string is untouched.
+
+**Honest NFR-1 finding.** MEASURED against the real 743-pattern production store on this machine,
+100 real prompts from `.dz/recall-usage.jsonl`, under the documented default budget: EVERY reply
+fell back to `cosine-fallback` — `resolveAgentdbEmbedder` (`agentdb-index.ts`) reconstructs the
+transformers pipeline on every call with no cross-call caching (measured standalone: 2–3.6 s/call,
+no warm-up across repeats in one process), so a cold semantic leg routinely exceeds the 500 ms
+budget. The p95/p50/reproducer script live in
+`features/hook-recall-hybrid-parity/07_code_changes/change_manifest.md`. Fixing the embedder's own
+cache is `agentdb-index.ts` work, outside this feature's touched files — named here as a follow-up,
+not silently absorbed into a passing-looking number.
+
 ## Run a plan without the Claude host
 
 `runWorkflow` (`workflow-run.ts`) is the PURE scheduler behind `dz workflow run`: it INTERPRETS a
@@ -812,6 +868,28 @@ unchanged) from "the store file itself is unreadable" (corrupt file, permission
 one `dz: <path> unreadable (<cause>) — falling back to the JSON store` line on stderr per process in
 the second case, so a broken store no longer looks like plain "fewer lessons".
 
+## Embedder cache (`agentdb-index.ts` — `resolveAgentdbEmbedder`)
+
+`resolveAgentdbEmbedder(projectRoot)` resolves agentdb's `EmbeddingService` and stands up the
+`@huggingface/transformers` pipeline behind it — MEASURED 2026-09-14 at 2-3.6s per call
+(`features/agentdb-embedder-cache/00_complexity_assessment.md`), because the model+dim for a
+project never changes within one process. It is now cached at module scope, keyed by
+`${agentdbDir}|${model}|${dim}` (so a `DZ_EMBED_MODEL`/`.dz/config.json` change — a different
+`resolveEmbedModel` result — gets its own entry rather than reusing a stale pipeline):
+
+- Repeat calls for the same key return the **same object**, not a re-initialized one — MEASURED
+  2026-09-14 (`test/agentdb-embedder-cache.test.ts`, live model): cold call `2117ms`, warm call
+  `1ms` (budget: ≤50ms).
+- The **promise** is cached, not the awaited result, so concurrent first callers for the same key
+  join one in-flight initialization instead of racing two pipelines (`getAgentdbEmbedderCacheStats()`
+  reports `initializations: 1` for two parallel first calls).
+- An `{error}` outcome (or a rejection) evicts its own cache entry immediately, so a failed init
+  never "sticks" — the next call retries against the current config.
+- `resetAgentdbEmbedderCache()` clears the cache and the `initializations` counter; it exists for
+  tests and future warm-start use only — `vector-tier.ts`/`backlog.ts` call sites are unaffected.
+- `getAgentdbEmbedderCacheStats()` returns `{ entries, initializations }` (`entries` = currently
+  cached successful pipelines, `initializations` = pipelines actually started since the last reset).
+
 ## Consistent pre-reindex snapshot + rollback (`agentdb-snapshot.ts`)
 
 The pre-reindex snapshot `reindexAgentdbRows` takes before every reindex used to be a bare

package/dist/agentdb-index.d.ts

@@ -101,16 +101,26 @@ export interface AgentdbSearchResult {
     readonly hits: AgentdbSearchHit[];
     readonly error?: string | undefined;
 }
+type Embedder = {
+    embed: (t: string) => Promise<Float32Array>;
+} | {
+    error: string;
+};
+/** Test-only (and future warm-start) reset — callers (`vector-tier.ts`, `backlog.ts`) are unaffected. */
+export declare function resetAgentdbEmbedderCache(): void;
+/** `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 declare function getAgentdbEmbedderCacheStats(): {
+    entries: number;
+    initializations: number;
+};
 /**
  * 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.
+ * vectors stay in the same space. Cached per process — see {@link embedderCache} above.
  */
-export declare function resolveAgentdbEmbedder(projectRoot: string): Promise<{
-    embed: (t: string) => Promise<Float32Array>;
-} | {
-    error: string;
-}>;
+export declare function resolveAgentdbEmbedder(projectRoot: string): Promise<Embedder>;
 /**
  * Cosine similarity in [-1, 1] over two embeddings. Exported (was file-private) so
  * `harmonizeVectorStore` scores near-duplicate pairs with the IDENTICAL math the semantic search
@@ -246,4 +256,5 @@ export declare function reindexAgentdbRows(projectRoot: string, rows: readonly A
     /** AM-3: present only when `rollback === 'failed'` — why the restore did not fully complete. */
     rollbackError?: string;
 }>;
+export {};
 //# sourceMappingURL=agentdb-index.d.ts.map

package/dist/agentdb-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentdb-index.d.ts","sourceRoot":"","sources":["../src/agentdb-index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agentdb-index.d.ts","sourceRoot":"","sources":["../src/agentdb-index.ts"],"names":[],"mappings":"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"}

package/dist/agentdb-index.js

@@ -203,27 +203,35 @@ const DZ_TASK_TYPES = DZ_PATTERN_TASK_TYPES;
 export const DZ_OWNED_TASK_TYPES = ['dz-teach', 'dz-learning', 'dz-backlog'];
 const DEPS_MISSING = 'agentdb/better-sqlite3 not installed in project (run: dz setup --memory agentdb)';
 /**
- * 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) {
-    let agentdbDir;
-    try {
-        const req = createRequire(join(projectRoot, 'package.json'));
-        agentdbDir = dirname(req.resolve('agentdb'));
-    }
-    catch {
-        return { error: DEPS_MISSING };
-    }
+const embedderCache = new Map();
+let embedderCacheInitializations = 0;
+/** Test-only (and future warm-start) reset — callers (`vector-tier.ts`, `backlog.ts`) are unaffected. */
+export function resetAgentdbEmbedderCache() {
+    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() {
+    return { entries: embedderCache.size, initializations: embedderCacheInitializations };
+}
+async function initAgentdbEmbedder(agentdbDir, model, dim) {
     try {
         const { EmbeddingService } = (await import(pathToFileURL(join(agentdbDir, 'controllers', 'EmbeddingService.js')).href));
-        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
@@ -241,6 +249,42 @@ export async function resolveAgentdbEmbedder(projectRoot) {
         return { error: `embedder init failed: ${err instanceof Error ? err.message : String(err)}` };
     }
 }
+/**
+ * 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) {
+    let agentdbDir;
+    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, dbPath) {
     const dbFile = resolveAgentdbPath(projectRoot, dbPath);