@dzhechkov/harness-core 0.8.32 → 0.8.34

package/sbom.json

@@ -25,7 +25,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "54263cdc0ff93b433ed446ce4c4e73d65c8b9aa485d85e572619e4ac0f127acb"
+          "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": "a55d5bf49f07b754abf06b14d4e7d6aa588d068e3ef8078eb375256c67254583"
+          "content": "7d405581035820ac6e35fc3acf30685fb66f97120f4222d4389e81182cb234b6"
         }
       ]
     },
@@ -325,7 +325,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "1bce79ef725136a5f4f46520ffbba6b028fa407add47930e117472462a35d64a"
+          "content": "1ec81dba7e182385ee9cebd1d4c41128915549797fb07bbff0cc540b7f72287a"
         }
       ]
     },
@@ -335,7 +335,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "d7d36c98560831a883b6c161a8758789dd458981c1846c23f2a8791bc08009e0"
+          "content": "94a7c64d577a8134413cd508b37ec346cf729571b86b0d0cb55168d9a67f7a76"
         }
       ]
     },
@@ -345,7 +345,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "66b3a643d29f340c96c7d8bca16cc8e5ab39763db030d31ecf154b27f0a817de"
+          "content": "cc1ed9820f186de277c75bbcffd102e651e34283a7728307d4c377ad7e207b7a"
         }
       ]
     },
@@ -1869,6 +1869,46 @@
         }
       ]
     },
+    {
+      "type": "file",
+      "name": "dist/embed-socket-path.d.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "d1e9b3cb7982f012b3da1de5b97b2a584b14e00c74a8de4bdc481e48b52f414b"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/embed-socket-path.d.ts.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "67d855dd419e6221658bd96039db2328b4f0336f236dd5304de604f8b6d99045"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/embed-socket-path.js",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "c5d11ebcd03e0b952a7021206cdffe6474cbd79101dfdaf0dfcd302fec1d4302"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/embed-socket-path.js.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "aa0bcf9922795cd37e0be3fed8b8de7750e981e5cc6c373848fc283a9a581926"
+        }
+      ]
+    },
     {
       "type": "file",
       "name": "dist/embedding-config.d.ts",
@@ -2555,7 +2595,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "fd97f39647b729ea810c902f273fdfc36f59e567f3a4884290bed49fff4ec052"
+          "content": "0ec8aabd62c19b421d56b9ddfc3a769ca88a6edad072e6b458a9ec0dce144847"
         }
       ]
     },
@@ -2565,7 +2605,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "d6430786c63f4b4fa3fada8187ac9402aa3594872a0db2c88ec7a2d5d9c822dc"
+          "content": "d55811cc24161673964196697f78774b618ceff986f12d61233129af1309a06e"
         }
       ]
     },
@@ -2575,7 +2615,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "b47ef22031aadc12196f5baec464fcc1f7feeeb0b72777e8b14016d7c78cfb95"
+          "content": "db5d3897a75a8b5f41e4d63fc2b89e1ba0ad59d81c9ec7409f4a4e4bcaef3ed2"
         }
       ]
     },
@@ -2585,7 +2625,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "16328408edcd3a051077e91cabaf1e4d83b89f4e6f299cdea7036704d2d9f8a8"
+          "content": "7ed1c3d692bf9f60b3239b2ec714552c524139f98a666529c1c614c00b1928a2"
         }
       ]
     },
@@ -3685,7 +3725,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "ed5a263c47219eaa072cce5a0abaa470c32c9289ebe88f8b62294957ecebc120"
+          "content": "5e21fd824b54842ab455e1c2b4d381d3ba81eaefb37ee525ab44b61f3e1a4719"
         }
       ]
     },
@@ -3695,7 +3735,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "fb7ab749fea417fa2674b414b8a4b9447aba71f452d0013c7b2c434c51755e1c"
+          "content": "cb895bd26042f722c29594f1c5d0db6471146516745de6b366ed3b1a06af1906"
         }
       ]
     },
@@ -3705,7 +3745,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "d35bd1d760e49c2e0c5e95d350f121ccdc4f7de11ba498d42767d58cb26dc749"
+          "content": "3d7103bd1f9c96aefe9ade44d53a321ae5c057171a6556b228350fc3faf74f33"
         }
       ]
     },
@@ -3749,6 +3789,46 @@
         }
       ]
     },
+    {
+      "type": "file",
+      "name": "dist/packed-install-smoke.d.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "5fab8ab0b347d09711324875be550ce44724dca46d56be901f86dffd471e0506"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/packed-install-smoke.d.ts.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "3f3bdc901c79b61534649c138306756cc2b59df0682def6ca903d3632e9fcfa7"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/packed-install-smoke.js",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "440ae2f1a8876ffae09f3a01534973a9fb7666b6ca963d7ecd01760d6abb32f5"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/packed-install-smoke.js.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "0b929c1db7a5cc426160c4e2c19b16bf3db5e4a54a55719b46ea6d69d016277e"
+        }
+      ]
+    },
     {
       "type": "file",
       "name": "dist/parity.d.ts",
@@ -4109,6 +4189,46 @@
         }
       ]
     },
+    {
+      "type": "file",
+      "name": "dist/publish-sibling-drift.d.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "8e39c9f1d527ddaaa8b8655ee1e2fa0ee005926e25da8c3218cf0fb9cbed5502"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/publish-sibling-drift.d.ts.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "257237bac3a1d173113b4525ea19dbb4f7984a08ad017ebdd7af164ba6cc7cfe"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/publish-sibling-drift.js",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "16ac3f704998f295ed42c112277482d6adfb5d26e4c8a4c89781d24b63118f6f"
+        }
+      ]
+    },
+    {
+      "type": "file",
+      "name": "dist/publish-sibling-drift.js.map",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "8143d41cd1c706713fe6d9a742b71d9a28b3519a72072ca4683837ab54732d30"
+        }
+      ]
+    },
     {
       "type": "file",
       "name": "dist/publish-signing.d.ts",
@@ -4155,7 +4275,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "613cf29c62332171a95b152ebc73d383a71e7ba2ff2d97ed1619f9a1f6f77b96"
+          "content": "c2494e9728e80aecd427671f17f252d250ea8866e5b1770efa74f64e37ced8d7"
         }
       ]
     },
@@ -4165,7 +4285,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "52bd5d82f546c0a9dce2a25b4775c44502d199ea1e11c33a0e0f4ca9c986215e"
+          "content": "a4cedae6fed2af78018ae9db1d57f71008373df4c42a9d23f6b73e0a1fde00a1"
         }
       ]
     },
@@ -4175,7 +4295,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "23aa88616d9296bd571619baca8f31524c4c21ca3844dc71971ea66e56172238"
+          "content": "5521d2668e6ddb77086a911166eee4b7df1776ff94b23b5bab9ba927d479b6d4"
         }
       ]
     },
@@ -4185,7 +4305,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "b6a45c54545e890424561cf8bfcbfa8f98061852ffc6b1fcaea526eb420a5a9e"
+          "content": "2dae5163293e7aa626a27d8da7642a82437b8bdac98b2735706f535572ec71c1"
         }
       ]
     },
@@ -4195,7 +4315,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "dc7d9b6325d8ef314d75834c649aeca914e0453324d1dbd631508b5d6e3e400d"
+          "content": "7bf6a9f4bbd79eef7858d3a5e073fbb897d7af01accf9257894635664432f449"
         }
       ]
     },
@@ -4205,7 +4325,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "0a32cc82bbc3b5df2576495e5d4823b32ddcc4375b9217d3c8a008cc68054997"
+          "content": "6eac09175e7d75786e831dc07a79fa17574a61cbe607ffecbe263ac4248f818d"
         }
       ]
     },
@@ -4215,7 +4335,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "805dbe6e3d2e60b243b51b5f76c688707f1634625ab5326723f8e7e28b4f0246"
+          "content": "c61ce95a1fe307b340cb247cb7eb82708525452a12621fa42345e1561eb200e8"
         }
       ]
     },
@@ -4225,7 +4345,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "82b9a67c5432a3b2d029720a16c7336b1443ed8b7f00e7ce911fb4eb31e106e5"
+          "content": "5f9c7d67e269024896199f171d84e918d6adb71d022983bfc959b3697d78be67"
         }
       ]
     },
@@ -4635,7 +4755,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "ccc6b0c5267e3c6236f7abba5c9b436d728acff7e1265b8661633150006da7aa"
+          "content": "937161c359ffed77233d43ba2b5280cd8f34962baa1758daf8479805e23621ef"
         }
       ]
     },
@@ -4645,7 +4765,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "e73877b3aa674936b7b195f7d2f310cfb8490d0c1c341c56612eb93cad4d7fb1"
+          "content": "6ce025a95be2b36246e6a8dbe3b324539e60d3f79febe1330071e51fced1282a"
         }
       ]
     },
@@ -4655,7 +4775,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "c7af542cf783fcd639e6c0b3e15463864aaa816d93abce5e05c39d75979d4b1f"
+          "content": "0030839d3dfaa43dabed352703255a7f6f0e11c8e3db01abaa4341fddb57e211"
         }
       ]
     },
@@ -4665,7 +4785,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "9123f8a37ffc19886f2940c700c2622509cd4deb0eea762ed3cc1e1f0907d17f"
+          "content": "2f1cfa37c4f868859e6ea2b5aba4b896bd106e8ed1a9a8b5285b9ad30e52d896"
         }
       ]
     },
@@ -5315,7 +5435,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "653c6b53ddece860e58a148e6293fdeb88a780b2bb794cbffe10f74406cf8e2d"
+          "content": "f83a15a0c183e2dc67d95323a3eae1eddfd8b375ca92a0de488081ec9d020603"
         }
       ]
     },
@@ -5325,7 +5445,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "b0be51ebb68bf00ba4649dd82a5ed862361e59a8911697e7e6a103e398ca801b"
+          "content": "baefa9d4a927880e51b8dc9ec4b899e7625c029de82ed397501b32cb1d3e925a"
         }
       ]
     },
@@ -5335,7 +5455,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "0c2b6ff57f0362bb17c5c28843b52e8801f71218121dc0d6260d684aa7068d68"
+          "content": "6f8cbb59ffc98b5f8722134b9b28b4d2bd5d847fe50edc38d2f539ebc9980151"
         }
       ]
     },
@@ -5345,7 +5465,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "ee3832352ba91e98f5497a3de74bfe6fdb395392a007eaa689974dd1cc2207fb"
+          "content": "f859ac7532e6b9d2232fbdbe6f7b3cb5e0a739842bc70024544c9263f78ec67e"
         }
       ]
     },
@@ -6515,7 +6635,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "289cc4a73d023af16d44ab00caa4c1cad2cbe6bd6720b6eddf932ef37e200a5b"
+          "content": "cdf68fa28b6a7e78d0381a5b2d23647ae812fee004e31b4c8c3893a897fd6f6f"
         }
       ]
     },
@@ -6525,7 +6645,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "52e4813a1af157a58ea91b7787c44c09dfc68e44b0baee315182467913c4dc08"
+          "content": "2943b848f7af427dcfecf801a778fe7eb2a6f899e395956aca5f45a9fcce3d79"
         }
       ]
     },
@@ -6535,7 +6655,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "cf0d978a1e9bffb32a854d20a0a88a4daad7e852f12287db15ae1707c0db66a3"
+          "content": "a48e13d799185bc95134a23cbe7d9ee91f9dcaf64c1c7c5faa4cf45a4cf94d08"
         }
       ]
     },
@@ -6545,7 +6665,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "f8db2ecd2284f2d5af15049443aa295c56fa3d67a2240bb4f08b884f36cf41bd"
+          "content": "9a74e49879f494f01aec757b4efe0f41245cf20cf1cc4e07123852f6939463cf"
         }
       ]
     },
@@ -6719,7 +6839,7 @@
         },
         {
           "name": "dz:canonical-json-sha256-v2",
-          "value": "2cd4274fb6e5283df38211af9daa121f9b8d0078c4ec6b9c7be7b9ff0d6f69e7"
+          "value": "26a1b1c5cd3d01ea854d9fb9ef126fe3cfd6580a52d0a1c7b60f4dffcc280d8d"
         }
       ]
     },
@@ -6739,7 +6859,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "49c55278320cf79d50463374cb4bd98702381eefc61aa81cf3889f117857f7d0"
+          "content": "f3b7a86fc7ec49fc7b47d69a6beb4ace4e193f9a4b63237b257a7cae1879d4f7"
         }
       ]
     },
@@ -6799,7 +6919,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "1d8f1c5f6edf5f3cc26de81a5697aae835511826b38b67832d51943d9dd1d14c"
+          "content": "d0bc07ff16397b8d0d6b26fd72a770553f421902b81e3d5e775e08b4db4710a3"
         }
       ]
     },
@@ -7193,6 +7313,16 @@
         }
       ]
     },
+    {
+      "type": "file",
+      "name": "src/embed-socket-path.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "2168f61719813abe70d90493a1e12936e084ae43bfc59cf131d9ad9bcbe27939"
+        }
+      ]
+    },
     {
       "type": "file",
       "name": "src/embedding-config.ts",
@@ -7369,7 +7499,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "5df0f960a0c66a364f123c9e519a2dccce1cbda9fdf210d0dfc622cffaedb05f"
+          "content": "a2ae53ebaa9993545153419f615db85f7a2d412f61deddb44780773e8ea52be2"
         }
       ]
     },
@@ -7659,7 +7789,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "3f4047a17032ba1b84facf899b9934d4b4b5e4e126d84895c2a4dc2265343b8b"
+          "content": "9f20a5a9c3e6ff41245612f74f04f62e719744fab2f97ee9d93fcdf4fa52668b"
         }
       ]
     },
@@ -7673,6 +7803,16 @@
         }
       ]
     },
+    {
+      "type": "file",
+      "name": "src/packed-install-smoke.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "c6c9ed22e4e06fc6de233efc1214349e60f66ea012c5162ef9fb1fcbc0a169d5"
+        }
+      ]
+    },
     {
       "type": "file",
       "name": "src/parity.ts",
@@ -7763,6 +7903,16 @@
         }
       ]
     },
+    {
+      "type": "file",
+      "name": "src/publish-sibling-drift.ts",
+      "hashes": [
+        {
+          "alg": "SHA-256",
+          "content": "5a7c2cffce4e62e4e859578b7014020670125e1ea68d4e04f2b1f6256c423b7a"
+        }
+      ]
+    },
     {
       "type": "file",
       "name": "src/publish-signing.ts",
@@ -7779,7 +7929,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "4c699867eb449f72e83407f9f5901f480f0e7a5a99412ea8e08c4dc06f0d1a4a"
+          "content": "00024c5a639339c5184bdad4d0ccf2e2e7d609cd74f25e64b624a43c22ac8625"
         }
       ]
     },
@@ -7789,7 +7939,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "5d4329089e2ad573a65663bfde91e2d94194dfe04f1bf4f8e1d7ac8f90db0e05"
+          "content": "abea068557211791925c6a046c71d49fa67753ec46c8f982f8f4351feb539970"
         }
       ]
     },
@@ -7899,7 +8049,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "aa9168da8584d311a2cdef736c2352180e6a52752a4d9859ad535d825cd502ad"
+          "content": "4e3390606a39f54b2a15db985a6e72a4f34c2ef59765c5124e1d64844d97447c"
         }
       ]
     },
@@ -8059,7 +8209,7 @@
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "d38887d6192184e02db4e3dc3932a88f09379c59fab92a146f7af17d80b11fdc"
+          "content": "795f796ad5093244807d5fd0c80478c89e28e3e3ef26540e8f636eb24d517038"
         }
       ]
     },
@@ -8369,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);